mcp-manager

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

MCP Manager Skill

Overview

概述

Natural language interface to MCP Manager CLI tool for managing Model Context Protocol server configurations. Users interact conversationally: "enable the filesystem MCP", "add a database server", "show me all my MCPs".

这是用于管理Model Context Protocol（MCP）服务器配置的MCP Manager CLI工具的自然语言界面。用户可以通过对话方式交互，例如：“启用文件系统MCP”、“添加数据库服务器”、“显示我所有的MCP”。

Activation

激活

Activates on MCP keywords within 3-message window or explicit invocation:

/mcp-manager

当在3条消息窗口内出现MCP关键词，或通过显式调用

/mcp-manager

时触发。

Commands

命令

1. List MCPs

1. 列出MCP

Display all configured MCP servers with status.

"List all my MCPs" / "Show me my MCP servers"
CLI:
```
python3 -m mcp-manager.cli list
```

显示所有已配置的MCP服务器及其状态。

示例语句：“列出我所有的MCP” / “显示我的MCP服务器”
CLI命令：
```
python3 -m mcp-manager.cli list
```

2. Enable MCP

2. 启用MCP

Activate a disabled MCP server.

"Enable the filesystem MCP" / "Turn on puppeteer"

CLI:

python3 -m mcp-manager.cli enable <server-name>

激活已禁用的MCP服务器。

示例语句：“启用文件系统MCP” / “开启puppeteer”

CLI命令：

python3 -m mcp-manager.cli enable <server-name>

3. Disable MCP

3. 禁用MCP

Deactivate an MCP server without removing it. Requires confirmation.

"Disable the puppeteer MCP" / "Turn off github"

CLI:

python3 -m mcp-manager.cli disable <server-name>

停用MCP服务器但不删除其配置。需要确认操作。

示例语句：“禁用puppeteer MCP” / “关闭github”

CLI命令：

python3 -m mcp-manager.cli disable <server-name>

4. Add MCP

4. 添加MCP

Add new MCP server interactively (collects name, command, args, env vars).

"Add a new MCP server" / "Configure a database MCP"

CLI:

python3 -m mcp-manager.cli add <name> <command> [args...] --env KEY=VALUE

以交互式方式添加新的MCP服务器（收集名称、命令、参数、环境变量）。

示例语句：“添加新的MCP服务器” / “配置数据库MCP”

CLI命令：

python3 -m mcp-manager.cli add <name> <command> [args...] --env KEY=VALUE

5. Remove MCP

5. 删除MCP

Delete MCP server configuration completely. Requires confirmation with warning.

"Remove the puppeteer MCP" / "Delete the old-server"

CLI:

python3 -m mcp-manager.cli remove <server-name>

彻底删除MCP服务器配置。需要确认并给出警告。

示例语句：“删除puppeteer MCP” / “移除old-server”

CLI命令：

python3 -m mcp-manager.cli remove <server-name>

6. Show MCP

6. 查看MCP详情

Display detailed information for specific MCP server.

"Show me the filesystem MCP" / "Details for github server"

CLI:

python3 -m mcp-manager.cli show <server-name>

显示特定MCP服务器的详细信息。

示例语句：“显示文件系统MCP的详情” / “查看github服务器的信息”

CLI命令：

python3 -m mcp-manager.cli show <server-name>

7. Validate MCPs

7. 验证MCP配置

Check all MCP configurations for errors.

"Validate my MCP configuration" / "Check for MCP errors"
CLI:
```
python3 -m mcp-manager.cli validate
```

检查所有MCP配置是否存在错误。

示例语句：“验证我的MCP配置” / “检查MCP是否有错误”
CLI命令：
```
python3 -m mcp-manager.cli validate
```

8. Export MCPs

8. 导出MCP配置

Export configurations to JSON file for backup.

"Export my MCP configuration" / "Back up my MCPs"

CLI:

python3 -m mcp-manager.cli export [output-file]

将配置导出到JSON文件以进行备份。

示例语句：“导出我的MCP配置” / “备份我的MCP”

CLI命令：

python3 -m mcp-manager.cli export [output-file]

9. Import MCPs

9. 导入MCP配置

Import configurations from JSON file.

"Import MCPs from backup.json" / "Restore my MCPs"

CLI:

python3 -m mcp-manager.cli import <input-file> [--merge]

从JSON文件导入配置。

示例语句：“从backup.json导入MCP配置” / “恢复我的MCP配置”

CLI命令：

python3 -m mcp-manager.cli import <input-file> [--merge]

Usage Examples

使用示例

Example 1: List and Enable

示例1：列出并启用MCP

User: "List all my MCPs"

[Executes:

cd .claude/scenarios && python3 -m mcp-manager.cli list

]

Response: "You have 3 MCP servers configured: ✓ filesystem (enabled) - Local filesystem access ✓ github (enabled) - GitHub API integration ✗ puppeteer (disabled) - Browser automation"

Follow-up: "Turn on puppeteer"

[Executes:

python3 -m mcp-manager.cli enable puppeteer

]

"✓ Successfully enabled 'puppeteer' MCP server."

用户：“列出我所有的MCP”

[执行命令：

cd .claude/scenarios && python3 -m mcp-manager.cli list

]

响应： "你已配置了3个MCP服务器： ✓ filesystem（已启用）- 本地文件系统访问 ✓ github（已启用）- GitHub API集成 ✗ puppeteer（已禁用）- 浏览器自动化"

后续请求：“开启puppeteer”

[执行命令：

python3 -m mcp-manager.cli enable puppeteer

]

"✓ 成功启用'puppeteer' MCP服务器。"

Example 2: Add New Server

示例2：添加新服务器

User: "Add a new MCP for database access"

Interactive Collection:

Name: "postgres-local"
Command: "node /opt/mcp-servers/postgres/index.js"
Args: "--port 5432 --host localhost"
Env: "DATABASE_URL=postgresql://localhost:5432/mydb"

[Executes:

python3 -m mcp-manager.cli add postgres-local "node /opt/mcp-servers/postgres/index.js" --port 5432 --host localhost --env "DATABASE_URL=postgresql://localhost:5432/mydb"

]

"✓ Successfully added 'postgres-local' MCP server. Server is currently disabled. Enable with: 'enable postgres-local'"

用户：“添加用于数据库访问的新MCP”

交互式信息收集：

名称："postgres-local"
命令："node /opt/mcp-servers/postgres/index.js"
参数："--port 5432 --host localhost"
环境变量："DATABASE_URL=postgresql://localhost:5432/mydb"

[执行命令：

python3 -m mcp-manager.cli add postgres-local "node /opt/mcp-servers/postgres/index.js" --port 5432 --host localhost --env "DATABASE_URL=postgresql://localhost:5432/mydb"

]

"✓ 成功添加'postgres-local' MCP服务器。当前服务器处于禁用状态。可通过指令启用：'enable postgres-local'"

Example 3: Remove Server

示例3：删除服务器

User: "Remove the puppeteer MCP"

Confirmation: "⚠️ WARNING: You're about to remove 'puppeteer' MCP server. This will delete the configuration completely. This action cannot be undone. Are you sure? (yes/no)"

[User confirms: "yes"]

[Executes:

python3 -m mcp-manager.cli remove puppeteer

]

"✓ Successfully removed 'puppeteer' MCP server."

用户：“删除puppeteer MCP”

确认提示： "⚠️ 警告：你即将删除'puppeteer' MCP服务器。此操作将彻底删除其配置，且无法撤销。确定要继续吗？（是/否）"

[用户确认：“是”]

[执行命令：

python3 -m mcp-manager.cli remove puppeteer

]

"✓ 成功删除'puppeteer' MCP服务器。"

Tool Invocation

工具调用方式

All commands execute from

~/.amplihack/.claude/scenarios/

directory:

bash

cd .claude/scenarios && python3 -m mcp-manager.cli <command> [args]

Key Commands:

```
list
```
- List all MCPs
```
enable <name>
```
- Enable server
```
disable <name>
```
- Disable server

add <name> <cmd> [args...] --env KEY=VAL

- Add server

```
remove <name>
```
- Remove server
```
show <name>
```
- Show details
```
validate
```
- Validate all configurations
```
export [file]
```
- Export to JSON
```
import <file> [--merge]
```
- Import from JSON

Output Handling:

Success: Exit code 0, stdout with ✓ prefix
Error: Non-zero exit code, stderr with ❌ prefix
Redact sensitive info (tokens, passwords) in responses

所有命令均从

~/.amplihack/.claude/scenarios/

目录执行：

bash

cd .claude/scenarios && python3 -m mcp-manager.cli <command> [args]

核心命令：

```
list
```
- 列出所有MCP
```
enable <name>
```
- 启用服务器
```
disable <name>
```
- 禁用服务器

add <name> <cmd> [args...] --env KEY=VAL

- 添加服务器

```
remove <name>
```
- 删除服务器
```
show <name>
```
- 查看详情
```
validate
```
- 验证所有配置
```
export [file]
```
- 导出为JSON
```
import <file> [--merge]
```
- 从JSON导入

输出处理：

成功：退出码0，标准输出以✓开头
错误：非零退出码，标准错误输出以❌开头
在响应中自动脱敏敏感信息（令牌、密码等）

Error Handling

错误处理

Common Errors:

CLI Not Found: Offer installation instructions (see README)
Server Not Found: List available servers, suggest alternatives
Server Already Exists: Suggest show/remove/rename
Permission Denied: Check file/directory permissions
Malformed settings.json: Validate JSON, offer backup restore
Invalid Command: Show common command patterns

For detailed error scenarios and troubleshooting, see

~/.amplihack/.claude/scenarios/mcp-manager/README.md

常见错误：

CLI未找到：提供安装说明（参见README）
服务器不存在：列出可用服务器，提供替代建议
服务器已存在：建议查看详情/删除/重命名
权限不足：检查文件/目录权限
settings.json格式错误：验证JSON格式，提供备份恢复建议
命令无效：显示常见命令模式

有关详细错误场景和故障排除方法，请参阅

~/.amplihack/.claude/scenarios/mcp-manager/README.md

Best Practices

最佳实践

Always confirm destructive operations (disable, remove)
Validate server names before executing
Redact sensitive information in responses
Provide clear error messages with actionable next steps
Show current state before and after changes

对于破坏性操作（禁用、删除），始终要求确认
执行前验证服务器名称
在响应中脱敏敏感信息
提供清晰的错误消息及可操作的后续步骤
在更改前后显示当前状态

mcp-manager

Original

Translation

MCP Manager Skill

MCP Manager Skill

Overview

概述

Activation

激活

Commands

命令

1. List MCPs

1. 列出MCP

2. Enable MCP

2. 启用MCP

3. Disable MCP

3. 禁用MCP

4. Add MCP

4. 添加MCP

5. Remove MCP

5. 删除MCP

6. Show MCP

6. 查看MCP详情

7. Validate MCPs

7. 验证MCP配置

8. Export MCPs

8. 导出MCP配置

9. Import MCPs

9. 导入MCP配置

Usage Examples

使用示例

Example 1: List and Enable

示例1：列出并启用MCP

Example 2: Add New Server

示例2：添加新服务器

Example 3: Remove Server

示例3：删除服务器

Tool Invocation

工具调用方式

Error Handling

错误处理

Best Practices

最佳实践

See Also

相关链接