local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Referenced as a potential integration via the android-adb-mcp-server in configuration examples.
Referenced in usage examples for copying the brave-search MCP server configuration between clients.
Detects and manages configuration files on macOS systems, using platform-specific paths for client configuration management.
MCP 客户端配置服务器
此 MCP 服务器可帮助管理不同 MCP 客户端的配置。它提供从客户端配置文件中检索、列出、添加和删除服务器配置的工具。服务器会根据操作系统(Windows 或 macOS)和指定的客户端自动检测相应的配置文件路径。
安装
配置
要在您的 AI 助手中使用此 MCP 服务器,请将其添加到您的 MCP 设置配置中:
支持的客户机
- Cline :Claude 驱动的编码助手
- Roo Code :具有 AI 功能的代码编辑器
- WindSurf :人工智能浏览器
- Claude app :Claude AI 的桌面应用程序
注意: Cursor 不再受支持,因为它不使用标准配置文件进行 MCP 设置。Cursor 似乎以一种我们无法轻易修改的方式存储其 MCP 配置,这使其与此配置服务器基于文件的方法不兼容。
用法
该服务器特别适用于:
- 跨多个客户端管理 MCP 服务器:配置一次服务器并将其部署到多个客户端
- 自动化配置:脚本可以使用此服务器以编程方式管理 MCP 配置
- 故障排除:轻松检查已配置的服务器及其设置
示例:将服务器配置从 Roo Code 复制到 Claude 应用程序
这是一个简单的提示,您可以使用 AI 助手将 MCP 服务器配置从 Roo Code 复制到 Claude 桌面应用程序:
人工智能助手将在后台执行以下步骤:
- 从 Roo 代码获取服务器配置:
- 然后给Claude添加同样的配置:
这使得您可以轻松地在不同的 AI 助手之间同步您的 MCP 服务器配置。
工具
获取配置路径
检索指定客户端的配置文件路径。
参数:
client
(必填):客户名称(cline、roo_code、windsurf、claude)
返回:
- 配置文件的绝对路径
获取配置
检索指定客户端的完整配置。
参数:
client
(必填):客户名称(cline、roo_code、windsurf、claude)
返回:
- 来自客户端配置文件的完整 JSON 配置
列表服务器
列出指定客户端配置中配置的所有服务器名称。
参数:
client
(必填):客户名称(cline、roo_code、windsurf、claude)
返回:
- 服务器名称数组
获取服务器配置
从客户端的配置中检索特定服务器的配置。
参数:
client
(必填):客户名称(cline、roo_code、windsurf、claude)server_name
(必需):要检索的服务器的名称
返回:
- 指定服务器的 JSON 配置
添加服务器配置
在客户端的配置文件中添加或更新服务器配置。
参数:
client
(必填):客户名称(cline、roo_code、windsurf、claude)server_name
(必需):要添加或更新的服务器的名称json_config
(必需):JSON 格式的服务器配置
例子:
返回:
- 包含更新配置的成功消息
删除服务器配置
从客户端的配置文件中删除服务器配置。
参数:
client
(必填):客户名称(cline、roo_code、windsurf、claude)server_name
(必需):要删除的服务器的名称
返回:
- 已删除的配置或未找到服务器的消息
实现细节
- 服务器根据操作系统(Windows 或 macOS)和指定的客户端检测适当的配置文件路径。
- 所有配置文件修改后均以美化的JSON格式维护。
- 当配置文件不存在或无法访问时,提供错误处理。
- 如果配置文件和目录不存在,服务器会自动创建。
- 每个客户端的配置路径:
- 窗户:
- Cline:
%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
- Roo 代码:
%APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
- 风帆:
%APPDATA%\WindSurf\mcp_settings.json
- 克劳德:
%APPDATA%\Claude\claude_desktop_config.json
- Cline:
- macOS 系统:
- Cline:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Roo 代码:
~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
- 风帆:
~/.codeium/windsurf/mcp_config.json
- 克劳德:
~/Library/Application Support/Claude/claude_desktop_config.json
- Cline:
- 窗户:
故障排除
常见问题
- 未找到配置文件
- 添加新服务器时,如果配置文件不存在,则会自动创建。
- 对于其他操作,如果配置文件不存在,您将收到一条错误消息。
- 服务器已存在
- 添加已存在的服务器时,您需要将
allow_override
设置为true
才能更新它。 - 例子:Copy
- 添加已存在的服务器时,您需要将
- 不受支持的平台
- 目前仅支持 Windows 和 macOS。
- 未来版本可能会添加 Linux 支持。
最佳实践
- 在尝试更新或删除服务器之前,请务必检查服务器是否存在。
- 在客户端之间使用一致的服务器名称可以简化管理。
- 考虑使用环境变量来存储服务器配置中的敏感信息。
You must be authenticated.
Tools
一种帮助管理和同步不同 AI 助手客户端(Cline、Roo Code、WindSurf、Claude)之间的 MCP 服务器配置的工具,可自动从客户端配置文件中检索、列出、添加和删除服务器配置的过程。