Back to MCP directory
publicPublicdnsLocal runtime

mcp-server-manager-v5r

一个Python脚本工具,用于管理和运行MCP(Model Context Protocol)服务器,支持通过Supergateway将stdio服务器转换为SSE服务器,提供多服务器并行运行、自动重启和进程管理功能。

article

README

🚀 MCP 服务器指南

本指南将帮助你轻松完成 MCP 服务器的安装、配置、管理,并将其集成到 Cursor 中,从而增强 AI 助手的功能。

🚀 快速开始

📦 安装指南

安装依赖

  1. 确保你已经安装了 Python 和 pip。
  2. 使用以下命令安装必要的包:
pip install psutil requests

初始化配置

  • 创建并编辑 mcp_config.json 文件,添加你的服务器配置。

启动 MCP 服务器

  1. 启动所有服务器:
make run-servers
  1. 单独启动某个服务器:
python mcp_servers.py run <server_name>

💻 使用示例

配置格式

{
  "servers": [
    {
      "name": "github-api",
      "command": "python",
      "args": ["github_mcp_server.py"],
      "env": {
        "API_KEY": "${GITHUB_API_KEY}"
      },
      "port": 8080,
      "server_type": "stdio"
    },
    {
      "name": "perplexity-api",
      "command": "python",
      "args": ["perplexity_mcp_server.py"],
      "env": {},
      "port": null,
      "server_type": "sse"
    }
  ]
}

📚 详细文档

使用与管理

列出服务器
python mcp_servers.py list
停止服务器
  1. 停止所有服务器:
make stop-servers
  1. 单独停止某个服务器:
python mcp_servers.py stop <server_name>
删除服务器配置
python mcp_servers.py remove <server_name>

使用 MCP 服务器与 Cursor 集成

配置 Cursor 的 MCP 设置
  1. 创建或编辑 ~/.cursor/mcp.json 文件。
  2. 添加你的 MCP 服务器,例如:
{
  "mcpServers": {
    "filesystem": {
      "url": "http://localhost:8090/sse"
    },
    "youtube": {
      "url": "http://localhost:8092/sse"
    }
  }
}
可用的 MCP 服务器
  • filesystem(端口 8090):访问本地文件系统
  • youtube(端口 8092):搜索和获取 YouTube 视频
  • fetch(端口 8093):执行 HTTP 请求
  • github(端口 8094):与 GitHub 仓库交互
  • brave-search(端口 8096):网页搜索功能
  • google-maps(端口 8098):地图和位置服务
在 Cursor 中测试 MCP 服务器
  1. 打开 Cursor。
  2. 启动新的聊天,输入类似以下的问题:
    • "请列出我的下载文件夹中的所有文件。"
    • "搜索 YouTube 上的 '人工智能教程'。"

通过以上步骤,你可以轻松配置和管理 MCP 服务器,并将其集成到 Cursor 中,以增强你的 AI 助手功能。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client