MCP Server Manager

用于管理Claude Code中的MCP服务器的命令行工具。支持用户级和项目级的服务器安装和配置。

快速开始

# 从模板创建配置
cp mcp-servers.json.example mcp-servers.json

# 将服务器添加到用户范围
make add SERVERS=memory,brave-search

# 同步所有已配置的服务器
make sync

# 列出已安装的服务器
make list

要求

• 已安装Claude CLI (npm install -g @anthropic-ai/claude-code)
• Python 3.8+ 和 Ansible (pip install ansible)
• Node.js 18+ （用于Claude CLI）

安装

1. 克隆此仓库
2. 安装Ansible：pip install ansible
3. 验证Claude CLI：claude --version

基本用法

服务器管理

# 添加特定服务器
make add SERVERS=memory,github

# 移除服务器
make remove SERVERS=memory

# 列出所有服务器
make list

# 从配置文件同步
make sync

项目级操作

# 将服务器添加到当前项目
make project-add SERVERS=github

# 列出项目服务器
make project-list

# 同步项目服务器
make project-sync

远程操作

# 在远程主机上配置服务器
make sync-remote SSH_HOST=192.168.1.100 SSH_USER=ubuntu

# 将服务器添加到远程Claude CLI
make add-remote SERVERS=memory SSH_HOST=server.example.com SSH_USER=admin

配置

服务器配置

编辑 mcp-servers.json 来定义可用服务器：

{
  "memory": {
    "command": "npx",
    "args": ["-y", "@anthropic-ai/mcp-server-memory"],
    "env": {}
  },
  "github": {
    "command": "npx",
    "args": ["-y", "@anthropic-ai/mcp-server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
    }
  }
}

环境变量

创建 .env 文件来存放API密钥和秘密：

GITHUB_TOKEN=ghp_your_token_here
BRAVE_API_KEY=your_brave_key_here

服务器配置中的变量使用 ${VAR_NAME} 语法进行替换。

命令

命令	描述
list	列出已安装的服务器
add	添加服务器 (SERVERS=name1,name2)
remove	移除服务器 (SERVERS=name1,name2)
sync	从配置同步所有服务器
clean	移除孤立的服务器
project-list	列出项目服务器
project-add	将服务器添加到项目
project-sync	同步项目服务器
dry-run	预览更改而不应用

高级用法

对于复杂场景，直接使用Ansible：

# 自定义配置文件
ansible-playbook ansible/manage-mcp.yml -e "config_file=my-config.json"

# 使用自定义参数执行特定操作
ansible-playbook ansible/manage-mcp.yml \
  -e "mode=individual" \
  -e "operation_mode=add" \
  -e "servers=memory,github"

参见 docs/ADVANCED.md 获取完整的Ansible文档。

配置文件

• mcp-servers.json - 服务器定义和配置
• .env - 环境变量和API密钥（可选）
• ansible/group_vars/all.yml - 默认Ansible变量

示例

参见 ansible/examples/ 中的示例配置：

• mcp-s-ervers.json - 示例服务器定义
• secrets.yml.example - 环境变量模板

文档

• 高级用法 - 直接使用Ansible
• 配置指南 - 详细的配置选项
• 贡献指南 - 开发指南

许可证

MIT 许可证 - 查看 LICENSE 文件获取详情。