MCP Server Manager for Cursor

MCP Server Manager for Cursor

site icon
2025.05.08 0
TypeScriptMCP 服务器管理开发工具开发效率
Cursor MCP Manager 是一个用于管理多个 MCP(Model Context Protocol)服务器的工具,旨在简化本地开发环境中 MCP 服务器的配置和操作流程。它提供统一的 CLI 接口,支持启动、停止、更新和检查服务器状态,并自动管理 Cursor 的 MCP 配置文件。
View on GitHub

Overview

基本能力

产品定位

Cursor MCP Manager 是一个 MCP 服务器管理工具,专注于简化 MCP 服务器的配置和操作流程,提升开发效率。

核心功能

  1. 统一管理:支持同时管理多个 MCP 服务器,包括 HTTP/SSE 和 STDIO 类型的服务器。
  2. 自动化配置:自动更新 Cursor 的 MCP 配置文件(mcp.json),确保配置与服务器状态同步。
  3. 健康检查:提供标准化的健康验证机制,支持对服务器进行健康状态检查。
  4. 日志管理:支持查看和实时流式传输服务器日志,便于调试和监控。
  5. 动态端口分配:为 HTTP/SSE 服务器自动分配可用端口(如未指定固定端口)。

适用场景

  1. 多服务器管理:适用于需要同时管理多个 MCP 服务器的开发环境。
  2. 快速配置:适合需要快速配置和验证 MCP 服务器的场景。
  3. 调试与监控:用于调试服务器问题或监控服务器运行状态。

工具列表

  1. CLI 命令
  2. start:启动服务器。
  3. stop:停止服务器。
  4. status:检查服务器状态。
  5. logs:查看服务器日志。
  6. health-check:执行健康检查。
  7. update:更新服务器镜像。
  8. 健康验证工具:支持通过 JSON-RPC 2.0 请求验证服务器健康状态。

常见问题解答

  1. 服务器启动失败:检查 Docker 是否运行,并查看日志(deno task logs --server=<server-name>)。
  2. 配置未同步:确保 CURSOR_MCP_CONFIG_PATH 环境变量指向正确的配置文件路径。
  3. 健康检查失败:验证服务器配置和 .env 文件中的凭证是否正确。

使用教程

使用依赖

  1. 安装 Deno:确保 Deno 已安装并配置到系统 PATH 中。
  2. 安装 Docker:确保 Docker 已安装并运行。

安装教程

  1. 克隆项目仓库: bash git clone <repository-url> cd cursor-mcp-manager
  2. 初始化配置:
  3. 复制示例配置文件(examples/ 目录)到 servers/ 目录。
  4. 创建 .env 文件并填写凭证(参考 examples/*.env.example)。

调试方式

  1. 启动服务器: bash deno task start --server=<server-name>
  2. 查看日志: bash deno task logs --server=<server-name> --stream
  3. 健康检查: bash deno task health-check --server=<server-name>

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。