MCP Server Manager

MCP Server Manager

一个适用于 Cursor 和 Claude Desktop 的 MCP（Model Control Protocol）服务管理器，提供命令行（CLI）和图形（GUI）界面，方便管理 MCP 服务。

🔎 概述

MCP Server Manager 让创建、配置和管理 MCP（Model Control Protocol）服务变得更加轻松。 本项目主要面向希望使用 Cursor 和 Claude Desktop 创建、测试和使用本地 MCP 服务的开发者。

📋 功能

• MCP 服务管理： 启动、停止、重启和监控 MCP 服务
• 双重界面： 命令行界面和图形界面
• 现代图形界面： 通过可视化界面管理 MCP 服务
• 实时日志： 查看各项服务生成的日志
• 双向通信： 向服务发送命令并接收响应
• 多服务管理： 同时管理多项服务
• 持久运行： 即使关闭界面，正在运行的服务也会继续运行
• 自动配置： 与 Cursor 和 Claude Desktop 集成
• 进程检测： 自动识别正在运行的服务
• 重复进程检查： 启动时以及每隔 5 分钟自动检查重复进程
• 快速设置： 为新环境提供快速配置系统
• 服务导入： 可通过图形界面导入现有 MCP 服务
• 多平台支持： 兼容 Windows 和 macOS
• 环境管理： 自动配置 Python 环境

🖥️ 兼容性

平台	状态	备注
Windows	✅ 完整支持	已在 Windows 10/11 上测试
macOS	✅ 完整支持	已在 macOS 12+ 上测试
Linux	⚠️ 部分支持	实验性支持

🔍 项目范围

当前限制

重要： 当前版本的 MCP Server Manager 仅支持本地 MCP 服务。

这意味着：

• ✅ 本地服务：本项目允许创建、配置和运行与 LLM 客户端位于同一台机器上的 MCP 服务
• ✅ stdio 传输：已实现的服务使用标准输入/输出进行通信
• ✅ 专属管理：该系统仅管理“mcp_server”目录中的服务
• ❌ 远程服务：目前不支持通过 HTTP/SSE 连接远程 MCP 服务
• ❌ OAuth 身份验证：我们尚未实现远程服务所需的身份验证

技术详情

此管理器创建的服务：

• 仅使用 stdio 传输进行通信
• 作为本地进程运行
• 不会向外部公开 HTTP 端点
• 适用于本地测试和开发

未来路线图

在未来版本中，我们计划添加：

• 支持通过 HTTP/SSE 连接远程 MCP 服务
• 集成 OAuth 身份验证，实现安全访问
• 简化在云环境中托管服务的流程
• 提供远程服务管理界面
• 全面支持 Linux
• 指标和性能面板
• 高级调试模式

📸 截图

图形界面（GUI）

命令行界面（CLI）

与 Cursor 集成

🎬 演示视频

🛠️ 使用的技术

• Python 3.10+
• 使用 Tkinter 和 ttkthemes 构建的 GUI
• 使用 Rich 构建的彩色格式化 CLI
• TOML 配置管理
• 使用 Psutil 检测进程
• 使用 UV 管理 Python 环境

🚀 安装

要求

• Python 3.10 或更高版本
• Pip（Python 包管理器）

安装步骤

1. 克隆仓库：

   git clone https://github.com/marcellobatiista/mcp-server-manager.git
   cd mcp-server-manager
   

2. 安装依赖：

   pip install -r requirements.txt
   

3. 运行快速设置：

   python quick_setup.py
   

验证安装

要验证安装是否成功，请运行：

mcp

你应该会看到 MCP Server Manager 的当前版本。

🚀 入门

要快速开始使用 MCP Server Manager，请按以下步骤操作：

1. 创建你的第一个服务

完成安装后，你可以创建第一个 MCP 服务：

1. 使用命令 mcp 启动图形界面
2. 在主屏幕上，点击“添加新服务”
3. 选择一个可用模板，或导入现有服务
4. 为服务命名
5. 点击“创建”以完成操作

2. 配置 Cursor

要在 Cursor 中使用你的服务：

1. 启动 Cursor
2. 打开设置（齿轮图标）
3. 转到“MCP 服务”部分
4. 使用 MCP Server Manager 创建的服务应该已经显示在列表中
5. 选择它以启用

3. 快速测试

要检查服务是否正常运行：

1. 在 MCP Server Manager 中，点击“启动”按钮启动服务
2. 打开 Cursor 并创建新文档
3. 在模型选择器中选择你的 MCP 服务
4. 输入一个简单的问题来测试响应

现在，你已准备好使用自定义 MCP 服务！

📚 使用方法

全局命令 'mcp'

成功运行 quick_setup.py 后，你可以在任意位置使用以下命令启动 MCP 图形界面：

mcp

ℹ️ 注意：安装后需要打开新的命令提示符，命令才能生效。

命令行界面（CLI）

要启动 CLI 界面：

.\cli-launcher.bat

或直接通过 Python 启动：

python cli/launcher.py

图形界面（GUI）

要启动图形界面：

.\gui-launcher.bat

或直接通过 Python 启动：

python gui/app.py

导入服务

要导入现有 MCP 服务：

1. 启动图形界面
2. 在服务管理选项卡中，点击“导入服务”按钮
3. 选择要导入的服务的 Python 文件（.py）
4. 系统会将该文件复制到 MCP 服务目录，并将其添加到可用服务列表中

📁 项目结构

项目结构如下：

主要目录

mcp-server-manager/
│
├── mcp_server/                  # Servidores MCP implementados
│   ├── demon.py                 # Servidor demon MCP de exemplo
│   └── main.py                  # Ponto de entrada para servidores
│
├── cli/                         # Interface de linha de comando (CLI)
│   ├── launcher.py              # Aplicação principal CLI
│   ├── add_mcp.py               # Utilitário para adicionar novos servidores
│   └── config_util.py           # Utilitários de configuração
│
├── gui/                         # Interface gráfica de usuário (GUI)
│   ├── app.py                   # Aplicação principal GUI
│   ├── server_manager.py        # Gerenciamento de servidores
│   ├── config_manager.py        # Gerenciamento de configurações
│   ├── utils.py                 # Utilitários e helpers
│   └── assets/                  # Recursos gráficos
│
├── config/                      # Configurações do sistema
│   ├── servers.json             # Lista de servidores disponíveis
│   └── app_config.json          # Configurações da aplicação
│
├── tests/                       # Testes automatizados
│   └── test_mcp_server.py       # Testes para verificar a estrutura do projeto
│
├── tools/                       # Scripts e ferramentas auxiliares
│
└── logs/                        # Registros de execução

主要文件

• quick_setup.py - 自动化初始设置
• cli-launcher.bat - 启动 CLI 的快捷方式
• gui-launcher.bat - 启动 GUI 的快捷方式
• requirements.txt - 项目依赖

🔧 配置

客户端配置文件

系统会与以下位置的配置文件交互：

• Cursor： %USERPROFILE%\.cursor\mcp.json
• Claude Desktop（Windows）： %USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json
• Claude Desktop（macOS）： ~/Library/Application Support/Claude/claude_desktop_config.json

手动配置

如果您更愿意手动配置客户端，请按照以下说明操作：

Cursor

1. 打开文件 %USERPROFILE%\.cursor\mcp.json
2. 将您的服务添加到 localMcpServers 列表中

Claude Desktop

1. 打开与您的系统相对应的配置文件
2. 在 mcp.localServers 部分中添加服务路径

🧪 测试

运行测试

运行自动化测试：

python -m pytest tests/

tests/ 目录包含用于检查以下内容的自动化测试：

• 预期目录结构是否存在
• 已实现的 MCP 服务是否存在
• Cursor/Claude Desktop 客户端的配置是否正确

❤️ 支持项目

本项目为开源项目，依据 MIT License 免费提供。

☕ 请我喝杯咖啡

如果此 MCP 服务管理器对您有帮助，请考虑支持项目的持续开发：

☕ 请我喝杯咖啡

🌟 您的支持带来的帮助

有了您的支持，我可以：

• ✅ 开发新功能
• ✅ 改进图形界面和用户体验
• ✅ 编写更多文档和教程
• ✅ 保持与新版 Cursor 和 Claude Desktop 的兼容性
• ✅ 投入更多时间解决问题并支持社区

🤝 其他贡献方式

• 代码： 提交 pull request，帮助改进项目
• 想法： 创建 issue，提出建议和期望的功能
• 分享： 向可能从中受益的人宣传本项目
• 文档： 帮助改进教程和文档

❓ 常见问题（FAQ）

什么是 Model Control Protocol（MCP）？

MCP 是一种协议，可让 Cursor 和 Claude Desktop 等应用与语言模型通信。它定义了应用如何向这些模型发送请求，以及如何接收模型的响应。

使用 MCP Server Manager 需要了解 Python 吗？

不一定。使用现有服务时，图形界面（GUI）直观易用，无需编程知识。不过，如果要开发自己的 MCP 服务，建议掌握 Python 基础知识。

除了 Cursor 和 Claude Desktop，我还能将 MCP Server Manager 用于其他应用吗？

可以，只要这些应用支持 MCP 协议即可。不过，我们的文档和测试主要侧重于与 Cursor 和 Claude Desktop 的集成。

运行本地 MCP 服务安全吗？

安全。本地 MCP 服务仅在您的计算机上运行，不会暴露外部 HTTP 端点。通信通过 stdio（标准输入/输出）进行，因此外部暴露风险有限。

MCP Server Manager 会占用很多系统资源吗？

不会。MCP Server Manager 经过轻量高效设计。资源占用主要取决于您运行的具体 MCP 服务。

我可以在生产环境中使用 MCP Server Manager 吗？

目前，MCP Server Manager 更适用于开发和测试环境。对于生产环境，我们建议等待未来版本提供远程服务支持和更多安全功能。

🔒 安全

安全实践

MCP Server Manager 的开发考虑了以下安全因素：

• 本地隔离：MCP 服务在本地运行，最大限度地降低外部暴露风险
• 无暴露端点：当前实现中没有暴露 HTTP 端点
• 输入验证：用户输入在处理前会经过验证
• 进程管理：服务进程会受到监控并得到安全管理

📄 许可证

本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。

---

_{由 Marcelo Batista 倾情开发 ❤️}