MCP 服务器管理器

一个后端 Python 应用程序，提供模型上下文协议 (MCP) 接口和 FastAPI Web 接口，用于管理与 Claude Desktop 集成的 MCP 服务器。

概述

MCP 服务器管理器允许您：

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

前提条件

• Python 3.13 或更高版本
• pip (Python 包安装程序)
• Claude Desktop (用于完整功能)

安装

克隆存储库 (如果适用)

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 Desktop 集成)：

python mcp_manager/mcp_server.py

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

MCP 工具

MCP 服务器管理器通过模型上下文协议提供以下工具：

1. restart_claude_desktop - 查找、终止并重启 Claude Desktop 应用程序
2. set_server_enabled_status - 在 Claude Desktop 中启用或禁用 MCP 服务器
3. install_mcp_server - 注册新的 MCP 服务器配置
4. start_fastapi_server - 启动 FastAPI 服务器并打开默认 Web 浏览器以查看 UI

使用 start_fastapi_server 工具

使用 Claude Desktop，您可以使用 MCP 工具直接启动 Web 界面：

start_fastapi_server

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

start_fastapi_server port=8080

这将：

1. 在后台启动 FastAPI 服务器
2. 打开您的默认 Web 浏览器到相应的 URL
3. 允许您通过 Web 界面管理您的 MCP 服务器

与 Claude Desktop 集成

要将 MCP 服务器管理器与 Claude Desktop 一起使用：

1. 使用 Web 界面注册您的 MCP 服务器
2. 启用您想要与 Claude 一起使用的服务器
3. 通过 Web 界面或手动重启 Claude Desktop

注意：如果您想直接使用其 MCP 功能，则需要配置 Claude Desktop 以识别 MCP 服务器管理器。 您可以将以下内容添加到 Claude Desktop 的配置文件中：

{
  "mcpServers": {
    "mcp-server-manager": {
      "command": "python",
      "args": ["path/to/mcp_manager/mcp_server.py"]
    }
  }
}

文件结构

• main.py: FastAPI Web 应用程序
• mcp_manager/: 核心模块
  • core_logic.py: 共享业务逻辑
  • mcp_server.py: MCP 服务器实现
• templates/: Web 界面的 HTML 模板
• static/: 静态资源 (CSS, JS)

开发

出于开发目的，您可能希望使用自动重新加载运行服务器：

uvicorn main:app --reload

当检测到代码中的更改时，这将自动重启服务器。

日志

MCP 服务器管理器的日志写入到：

C:\Users\<username>\AppData\Local\MCPManager\MCPManager\mcp_server.log

如果您遇到服务器的任何问题，请检查此文件以获取调试信息。