makecindy / makecindy/cindy

功能建议:为用户提供自定义 MCP 配置能力(GUI 设置面板 + 用户/项目级 .mcp.json 自动读取)

Open
#3,419 1 comment 0 reactions 0 assignees View on GitHub
feature
Dominant language
TypeScript
Stars
2.7k
Forks
401
Avg merge
21h 48m
Merged PRs (30d)
776

Description

**提交人**: HalFree
**客户端版本**: 0.1.60

---

## 功能建议:为用户提供自定义 MCP(Model Context Protocol)配置能力

### 使用场景
作为 Cindy 用户,我希望把团队内部或第三方的 MCP server(如数据库、内部 API、自建工具)接入 Cindy,让 Agent 在工作流中直接调用,而不只依赖平台预置的核心服务。

### 当前痛点 / 替代方案
- 当前会话可用的 `mcp__cindy_*` 工具均为平台内置核心服务(ssh / browser / feishu / orca / scheduler 等),由 Cindy 平台层托管,用户无法自行增删。
- 经本地核查,Cindy 底层代理引擎 `pi`(Claude Code 分支)在文档中明确声明 "intentionally does not include built-in MCP",因此不像 Claude Code 那样支持读取用户级/项目级 `mcpServers` 配置。
- 目前唯一的扩展入口是「插件(Codex plugin)」机制:在插件包内放置 `.mcp.json` 并借由 `.codex-plugin/plugin.json` 引用。该方式对普通用户门槛偏高,且缺少统一、可见的管理界面。

### 诉求
希望官方提供两类更友好的配置通道:
1. **应用内「添加 MCP」可视化设置面板**:用户填写 command / args / url / env 即可启用,无需手写文件。
2. **文件级自动加载**:全局配置与项目级 `.mcp.json` 中的 `mcpServers` 能被 Cindy 自动发现并连接(对齐 Claude Code 体验)。

### 建议方案
- 两类通道都提供(GUI 面板 + 文件级加载);若需排优先级,建议先上 GUI 面板以降低普通用户门槛。
- 兼容现有插件 `.mcp.json` 声明,将其作为一类来源纳入统一管理。
- 多 server 的启用/禁用、状态查看、连接日志应可在面板内查看。

### 环境(脱敏摘要)
- 客户端:Cindy 桌面端,底层引擎为 `pi`(Claude Code 分支)v0.83.0 区域构建。
- 已确认事实:底层 `pi` 文档 `docs/usage.md` 明确 "intentionally does not include built-in MCP, sub-agents, permission popups, plan mode, to-dos, or background bash"。
- 现有 MCP 扩展仅通过插件包的 `.mcp.json` 携带 server 声明(位于 Cindy 用户数据目录下的 `codex-home/.tmp/plugins/plugins/*/.mcp.json`),无用户侧直接配置入口。
---
**版本区域**: CN
**OS**: win32 x64 (10.0.26200)
**界面语言**: zh-CN

Contributor guide

Open the contributing guide

Research direction

Start by reading docs/usage.md and reviewing the existing plugin references to .mcp.json and .codex-plugin/plugin.json. Trace how plugin-bundled MCP declarations under the reported codex-home path are discovered and connected. Done should include a defined user/project configuration path and a visible interface for adding, enabling, disabling, and inspecting MCP servers.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
desktop
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.