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