MCP Client Configuration Server

MCP Client Configuration Server

site icon
2025.03.12 2
JavaScript配置管理多客户端同步开发效率
MCP Client Configuration Server 是一个用于管理不同 MCP 客户端配置的服务。它提供工具来检索、列出、添加和删除客户端配置文件中的服务器配置。该服务能根据操作系统(Windows 或 macOS)和指定的客户端自动检测适当的配置文件路径。
View on GitHub

Overview

基本能力

产品定位

MCP Client Configuration Server 主要用于管理多个 MCP 客户端的配置,帮助用户统一管理和同步不同客户端之间的服务器配置。

核心功能

  1. 配置管理:支持检索、列出、添加和删除客户端配置文件中的服务器配置。
  2. 跨客户端同步:支持将配置从一个客户端复制到另一个客户端。
  3. 自动化配置:支持通过脚本自动化管理 MCP 配置。
  4. 错误处理:自动创建配置文件和目录,提供错误处理机制。

适用场景

  1. 多客户端管理:适用于需要在多个 MCP 客户端之间同步配置的用户。
  2. 自动化脚本:适用于需要通过脚本自动化管理配置的场景。
  3. 故障排查:适用于需要检查配置和排查问题的场景。

工具列表

  1. get_configuration_path:获取指定客户端的配置文件路径。
  2. get_configuration:获取指定客户端的完整配置。
  3. list_servers:列出指定客户端中配置的所有服务器名称。
  4. get_server_configuration:获取指定客户端中特定服务器的配置。
  5. add_server_configuration:添加或更新客户端配置文件中的服务器配置。
  6. remove_server_configuration:从客户端配置文件中删除服务器配置。

常见问题解答

  1. 配置文件未找到:添加新服务器时,配置文件会自动创建。
  2. 服务器已存在:更新现有服务器时需设置 allow_overridetrue
  3. 不支持的平台:目前仅支持 Windows 和 macOS。

使用教程

使用依赖

无特殊依赖,只需安装 Node.js 环境。

安装教程

# 从 npm 安装
npm install -g @landicefu/mcp-client-configuration-server

# 或使用 npx 运行而不安装
npx @landicefu/mcp-client-configuration-server

配置

在 AI 助手的 MCP 设置配置中添加以下内容:

{
  "mcpServers": {
    "mcp-client-configuration": {
      "command": "npx",
      "args": ["-y", "@landicefu/mcp-client-configuration-server"],
      "env": {},
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

调试方式

  1. 使用 get_configuration 检查配置是否正确加载。
  2. 使用 list_servers 确认服务器配置是否存在。
  3. 使用 add_server_configurationremove_server_configuration 测试配置的添加和删除功能。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。