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 接口和 FastAPI 網絡接口，方便不同方式的管理與集成。
• 支持在中央位置對 MCP 服務器進行註冊和管理。
• 可靈活啟用或禁用 MCP 服務器與 Claude 桌面版的配合使用。
• 能在註冊前測試服務器命令，保障配置的準確性。
• 配置更改後可自動重啟 Claude 桌面版。
• 可通過 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

創建虛擬環境

# 使用 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 服務器管理器！如果有任何問題或建議，請隨時聯繫維護團隊。