返回 MCP 目录
public公开dns本地运行

mcp-(message-control-program)-servers

MCP服务器集合,提供多种API服务接口

article

README

🚀 MCP(消息控制程序)服务器

MCP(消息控制程序)服务器仓库提供了一组服务器,这些服务器具备多种服务和 API 接口。并且,每个服务器都能借助符号链接与 Cursor IDE 协同工作,为开发者带来便利。

🚀 快速开始

此仓库包含的 MCP 服务器可与 Cursor IDE 配合使用。首先,你需要将各个服务器通过符号链接配置到 Cursor IDE 目录:

~/.cursor/servers/github -> ~/mcp/github
~/.cursor/servers/gmail -> ~/mcp/gmail

✨ 主要特性

GitHub 服务器

  • 可对 GitHub 仓库进行管理。
  • 能处理 SSH 密钥身份验证。
  • 支持仓库的创建、删除以及列表操作。
  • 可使用 GitHub API 令牌增强功能。

Gmail 服务器

  • 能与 Gmail API 接口进行交互。
  • 支持电子邮件的读取和发送。
  • 使用 OAuth 2.0 进行身份验证。
  • 提供搜索功能。

📦 安装指南

每个服务器需通过符号链接配置到 Cursor IDE 目录,具体操作如下:

~/.cursor/servers/github -> ~/mcp/github
~/.cursor/servers/gmail -> ~/mcp/gmail

📚 详细文档

结构

mcp/
├── AI_README.md        # Python 最佳实践的人工智能代理说明
├── README.md          # 本文件
├── github/           # GitHub API 服务器
│   ├── server.py    # 主服务器实现
│   └── ...
└── gmail/           # Gmail API 服务器
    ├── server.py    # 主服务器实现
    └── ...

开发

  • 所有 Python 开发需遵循 AI_README.md 中的指南。
  • 使用 uv 进行 Python 包管理。
  • 每个服务器需维护自己的虚拟环境和依赖项。

安全

  • API 令牌和凭证会进行安全存储。
  • 在适用情况下使用 OAuth 2.0 令牌。
  • 敏感数据不会提交到版本控制。

贡献指南

若要添加新的 MCP 服务器,可按以下步骤操作:

  1. ~/mcp 中创建新目录。
  2. 按照 AI_README.md 中的 Python 项目结构进行开发。
  3. ~/.cursor/servers 中创建符号链接。
  4. 更新本 README 文件中的服务器详细信息。

📄 许可证

本项目采用 MIT 许可证,你可以随意使用和修改。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端