Claude Code MCP Management

MCP服务器管理器

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

快速开始

# Create configuration from template
cp mcp-servers.json.example mcp-servers.json

# Add servers to user scope
make add SERVERS=memory,brave-search

# Sync all configured servers
make sync

# List installed servers
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

基本用法

服务器管理

# Add specific servers
make add SERVERS=memory,github

# Remove servers  
make remove SERVERS=memory

# List all servers
make list

# Sync from configuration file
make sync

项目级运营

# Add servers to current project
make project-add SERVERS=github

# List project servers
make project-list

# Sync project servers
make project-sync

远程操作

# Configure servers on remote host
make sync-remote SSH_HOST=192.168.1.100 SSH_USER=ubuntu

# Add servers to remote 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} 用于替换的语法。

命令

高级用法

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

# Custom configuration file
ansible-playbook ansible/manage-mcp.yml -e "config_file=my-config.json"

# Specific operation with custom parameters
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-servers.json -服务器定义示例
• secrets.yml.example -环境变量模板

文档

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

许可证

MIT许可证-有关详细信息，请参阅许可证文件。