MCP Server Manager

MCP Server Manager

一个后端 Python 应用，同时提供模型上下文协议（MCP）接口和 FastAPI Web 接口，用于管理与 Claude Desktop 集成的 MCP 服务。

概览

MCP Server Manager 可用于：

• 在中心位置注册和管理 MCP 服务
• 启用或禁用供 Claude Desktop 使用的 MCP 服务
• 在注册前测试服务命令
• 配置更改后重启 Claude Desktop
• 通过 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

创建虚拟环境

# Using venv
python -m venv .venv

# Activate the virtual environment
# On Windows
.venv\Scripts\activate
# On macOS/Linux
source .venv/bin/activate

安装依赖项

选择以下一种方法：

# Using pip with requirements.txt
pip install -r requirements.txt

# OR using pip with pyproject.toml (recommended)
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：仅允许本地主机访问
• --host 0.0.0.0：允许网络中的其他设备访问服务（如有需要）
• --port 8000：应用运行所使用的端口

MCP 接口（可选）

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

python mcp_manager/mcp_server.py

MCP 服务以 stdio 模式运行，即从标准输入读取并写入标准输出。这是 MCP 协议所需的格式。

MCP 工具

MCP Server Manager 通过模型上下文协议提供以下工具：

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

使用 start_fastapi_server 工具

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

start_fastapi_server

也可以指定自定义端口：

start_fastapi_server port=8080

该工具将：

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

与 Claude Desktop 集成

要在 Claude Desktop 中使用 MCP Server Manager：

1. 使用 Web 界面注册 MCP 服务
2. 启用要与 Claude 配合使用的服务
3. 通过 Web 界面或手动重启 Claude Desktop

注意：如果要直接使用 MCP Server Manager 的 MCP 功能，需要将 Claude Desktop 配置为识别 MCP Server Manager。可将以下内容添加到 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 Server Manager 的日志写入：

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

如果遇到服务问题，请查看此文件以获取调试信息。