MCP Server Manager (Thomas Rohde)

MCP服务器管理器

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

概述

MCP服务器管理器允许您：

• 在中心位置注册和管理MCP服务器
• 启用/禁用MCP服务器以与Claude Desktop一起使用
• 注册前测试服务器命令
• 配置更改后重新启动Claude Desktop
• 通过MCP直接从Claude启动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

创建虚拟环境

# 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服务器管理器通过模型上下文协议提供以下工具：

1. restart_claude_desktop -查找、终止并重新启动Claude Desktop应用程序
2. 设置服务器启用状态 -在Claude Desktop中启用或禁用MCP服务器
3. 安装cp_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\\AppData\Local\MCPManager\MCPManager\mcp_server.log

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