MCP Server Manager

🚀 MCP 服务器管理器

MCP 服务器管理器是一个后端 Python 应用程序，它提供了 Model Context Protocol (MCP) 接口和 FastAPI 网络接口，可用于管理和集成与 Claude 桌面版结合使用的 MCP 服务器，为用户提供便捷的服务器管理体验。

🚀 快速开始

MCP 服务器管理器允许您：

• 在中央位置注册并管理 MCP 服务器
• 启用/禁用 MCP 服务器以供与 Claude 桌面版一起使用
• 在注册前测试服务器命令
• 在配置更改后重新启动 Claude 桌面版
• 通过 MCP 直接从 Claude 启动 FastAPI 服务器
• 通过 Web UI 和 MCP 接口访问功能

✨ 主要特性

• 支持中央管理 MCP 服务器，方便快捷。
• 可灵活控制 MCP 服务器的启用与禁用状态。
• 能在注册前对服务器命令进行测试，确保稳定性。
• 配置更改后可自动重启 Claude 桌面版。
• 支持通过 MCP 直接启动 FastAPI 服务器。
• 提供 Web UI 和 MCP 接口两种访问方式。

📦 安装指南

先决条件

• Python 3.13 或更高版本
• pip（Python 包安装程序）
• Claude 桌面版（以实现完整功能）

克隆仓库（如适用）

git clone https://github.com/yourusername/mcp-commander.git
cd mcp-commander/mcp_server_manager

创建虚拟环境

# 使用 venv
python -m venv .venv

# 激活虚拟环境
# 在 Windows 上
.venv\Scripts\activate
# 在 macOS/Linux 上
source .venv/bin/activate

安装依赖项

选择以下方法之一：

# 使用 pip 和 requirements.txt
pip install -r requirements.txt

# 或使用 pip 和 pyproject.toml（推荐）
pip install -e .

💻 使用示例

运行应用程序

Web 接口（推荐）

Web 接口提供友好的用户界面来管理您的 MCP 服务器。

uvicorn main:app --host 127.0.0.1 --port 8000

然后打开浏览器，导航到 http://127.0.0.1:8000

• --host 127.0.0.1：限制仅 localhost 访问
• --host 0.0.0.0：使服务器对网络上的其他设备可用（如需）
• --port 8000：应用程序运行的端口

MCP 接口（可选）

如果您需要直接访问 MCP 功能（例如，与 Claude 桌面版集成）：

python mcp_manager/mcp_server.py

MCP 服务器以标准输入/输出模式运行，这意味着它从标准输入读取并写入标准输出。这是 MCP 协议所期望的格式。

MCP 工具使用

MCP 服务器管理器通过 Model Context Protocol 提供以下工具：

1. restart_claude_desktop - 查找、终止并重新启动 Claude 桌面版应用程序
2. set_server_enabled_status - 启用或禁用与 Claude 桌面版一起使用的 MCP 服务器
3. install_mcp_server - 注册新的 MCP 服务器配置
4. start_fastapi_server - 启动 FastAPI 服务器并在默认网络浏览器中打开以查看界面

使用 start_fastapi_server 工具

通过 Claude 桌面版，您可以直接使用 MCP 工具启动 Web 接口：

start_fastapi_server

您还可以指定自定义端口：

start_fastapi_server port=8080

这将：

1. 在后台启动 FastAPI 服务器
2. 打开默认的网络浏览器以查看界面

📚 详细文档

集成方法

文件结构

项目文件结构如下：

mcp_commander/
├── mcp_server_manager/
│   ├── __init__.py
│   ├── server.py
│   └── utils.py
└── tests/
    └── test_server.py

开发

要运行开发环境，请按照以下步骤操作：

1. 克隆仓库：

   git clone https://github.com/yourusername/mcp-commander.git
   cd mcp-commander/mcp_server_manager
   

2. 创建虚拟环境并安装依赖项：

   python -m venv .venv
   source .venv/bin/activate  # 在 Windows 上使用 .venv\Scripts\activate
   pip install -r requirements.txt
   

3. 运行服务器：

   uvicorn main:app --host 127.0.0.1 --port 8000
   

4. 访问 Web 接口： http://127.0.0.1:8000

日志

日志文件位于 mcp_server_manager/log/ 目录中，格式为 mcp_server.log。

# 查看日志
tail -f mcp_server_manager/log/mcp_server.log

🔚 结束语

感谢使用 MCP 服务器管理器！如果有任何问题或建议，请随时联系维护团队。