mcp-manager

一个命令行工具，用于通过简单的YAML配置文件管理Claude项目中的MCP（模型上下文协议）服务器。

这是什么？

MCP服务器通过连接外部工具和数据源来扩展Claude的功能。然而，管理多个MCP服务器及其不同的安装命令、环境变量和配置可能会很复杂。

mcp-manager通过让你在一个.mcp.yml文件中定义所有的MCP服务器，并使用简单的命令进行安装或移除来解决这个问题。

安装

安装gem：

gem install mcp_manager

将示例配置复制到你的项目中：

cp .mcp.yml.example .mcp.yml

配置

在项目根目录创建一个.mcp.yml文件。这是其格式：

servers:
  server-name:
    description: "该服务器的作用"
    command: "claude mcp add server-name -e REQUIRED_ENV_VAR=\"$REQUIRED_ENV_VAR\" -- 安装命令"
    env_vars: ["REQUIRED_ENV_VAR"]

实际例子

从包含的.mcp.yml.example：

servers:
  github:
    description: "GitHub仓库集成（需要个人访问令牌）"
    command: 'claude mcp add github -s local -e GITHUB_PERSONAL_ACCESS_TOKEN="$GITHUB_PERSONAL_ACCESS_TOKEN" -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server'
    env_vars:
      - GITHUB_PERSONAL_ACCESS_TOKEN

  asana-remote:
    description: "Asana任务管理（OAuth）"
    command: "claude mcp add asana-remote -- npx -y mcp-remote https://mcp.asana.com/sse"
    env_vars: []

  google-workspace:
    description: "Gmail/日历集成（需要OAuth凭证）"
    command: 'claude mcp add google-workspace -s local -e GOOGLE_OAUTH_CLIENT_ID="$GOOGLE_OAUTH_CLIENT_ID" -e GOOGLE_OAUTH_CLIENT_SECRET="$GOOGLE_OAUTH_CLIENT_SECRET" -e OAUTHLIB_INSECURE_TRANSPORT="1" -- uvx workspace-mcp@latest --tools gmail calendar'
    env_vars:
      - GOOGLE_OAUTH_CLIENT_ID
      - GOOGLE_OAUTH_CLIENT_SECRET

使用方法

列出可用服务器

mcp-manager list

安装服务器

# 先设置所需的环境变量
export GITHUB_PERSONAL_ACCESS_TOKEN="你的令牌"

# 安装服务器
mcp-manager install github

移除服务器

mcp-manager uninstall github

命令

命令	别名	描述
install <server>	add	安装/添加一个MCP服务器
uninstall <server>	remove, rm	卸载/移除一个MCP服务器
list		列出所有可用服务器及其描述
--help	-h	显示帮助信息
--version	-v	显示版本

环境变量

许多MCP服务器需要API密钥或OAuth凭证。该工具会在安装前检查所需的环境变量并引导你完成设置：

# 示例：GitHub集成
export GITHUB_PERSONAL_ACCESS_TOKEN="你的GitHub PAT"

# 示例：Google Workspace
export GOOGLE_OAUTH_CLIENT_ID="你的客户端ID"
export GOOGLE_OAUTH_CLIENT_SECRET="你的客户端密钥"

将这些添加到你的shell配置文件（如.zshrc、.bashrc等）以持久化它们。

贡献

欢迎在GitHub上提交bug报告和拉取请求：https://github.com/ben/mcp-manager。

许可证

该gem作为开源软件发布，遵循MIT许可证条款。