使用说明
mcp经理
一个命令行工具，用于使用简单的YAML配置文件管理Claude项目中的MCP（模型上下文协议）服务器。
这是什么？
MCP服务器通过将Claude连接到外部工具和数据源来扩展其功能。但是，使用不同的安装命令、环境变量和配置管理多个MCP服务器可能很复杂。
mcp-manager 通过让您在单个文件中定义所有MCP服务器来解决这个问题 .mcp.yml 文件，然后使用简单的命令安装或删除它们。
安装
安装gem：
gem install mcp_manager
将示例配置复制到您的项目中：
cp .mcp.yml.example .mcp.yml
配置
创建一个 .mcp.yml 项目根目录中的文件。格式如下：
servers:
server-name:
description: "What this server does"
command: "claude mcp add server-name -e REQUIRED_ENV_VAR=\"$REQUIRED_ENV_VAR\" -- installation-command"
env_vars: ["REQUIRED_ENV_VAR"]
真实案例
从包括 .mcp.yml.example:
servers:
github:
description: "GitHub repository integration (requires Personal Access Token)"
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 task management (OAuth)"
command: "claude mcp add asana-remote -- npx -y mcp-remote https://mcp.asana.com/sse"
env_vars: []
google-workspace:
description: "Gmail/Calendar integration (requires OAuth credentials)"
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
安装服务器
# Set required environment variables first
export GITHUB_PERSONAL_ACCESS_TOKEN="your-token-here"
# Install the server
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凭据。该工具将在安装前检查所需的环境变量，并指导您完成设置：
# Example for GitHub integration
export GITHUB_PERSONAL_ACCESS_TOKEN="your-github-pat"
# Example for Google Workspace
export GOOGLE_OAUTH_CLIENT_ID="your-client-id"
export GOOGLE_OAUTH_CLIENT_SECRET="your-client-secret"
将这些添加到您的shell配置文件中(.zshrc, .bashrc等等）来坚持它们。
贡献
欢迎在GitHub上提交Bug报告和拉取请求，网址为https://github.com/ben/mcp-manager.
许可证
根据以下条款，gem可作为开源软件使用 MIT许可证.
