内容
<p align="center">
<img src="https://raw.githubusercontent.com/studyhubnetin-ui/modelcontextprotocolservers/main/assets/banner.png" alt="MCP Servers Hub Banner" width="800" />
</p>
<h1 align="center">🔌 MCP 服务器中心</h1>
<p align="center">
<strong>适用于 Claude AI 的精选模型上下文协议（MCP）服务器集合 - Anthropic Claude 工具、代理和 AI 工作流自动化的生产就绪集成。</strong>
</p>
<p align="center">
<a href="https://github.com/studyhubnetin-ui/modelcontextprotocolservers/stargazers"><img src="https://img.shields.io/github/stars/studyhubnetin-ui/modelcontextprotocolservers?style=for-the-badge&logo=github&logoColor=white&color=yellow" alt="星星"></a>
<a href="https://github.com/studyhubnetin-ui/modelcontextprotocolservers/network/members"><img src="https://img.shields.io/github/forks/studyhubnetin-ui/modelcontextprotocolservers?style=for-the-badge&logo=github&logoColor=white&color=blue" alt="分支"></a>
<a href="https://github.com/studyhubnetin-ui/modelcontextprotocolservers/blob/main/LICENSE"><img src="https://img.shields.io/github/license/studyhubnetin-ui/modelcontextprotocolservers?style=for-the-badge&color=green" alt="许可证"></a>
<a href="https://www.npmjs.com/package/mcp-hub-cli"><img src="https://img.shields.io/npm/v/mcp-hub-cli?style=for-the-badge&logo=npm&logoColor=white&color=red" alt="npm 版本"></a>
<a href="https://github.com/studyhubnetin-ui/modelcontextprotocolservers/pulls"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen?style=for-the-badge" alt="欢迎 PR"></a>
</p>
<p align="center">
<a href="https://github.com/studyhubnetin-ui/modelcontextprotocolservers/issues"><img src="https://img.shields.io/github/issues/studyhubnetin-ui/modelcontextprotocolservers?style=flat-square&color=orange" alt="问题"></a>
<a href="https://github.com/studyhubnetin-ui/modelcontextprotocolservers/graphs/contributors"><img src="https://img.shields.io/github/contributors/studyhubnetin-ui/modelcontextprotocolservers?style=flat-square&color=blue" alt="贡献者"></a>
<a href="https://github.com/studyhubnetin-ui/modelcontextprotocolservers/commits/main"><img src="https://img.shields.io/github/last-commit/studyhubnetin-ui/modelcontextprotocolservers?style=flat-square&color=purple" alt="最后一次提交"></a>
<a href="https://github.com/studyhubnetin-ui/modelcontextprotocolservers"><img src="https://img.shields.io/github/repo-size/studyhubnetin-ui/modelcontextprotocolservers?style=flat-square&color=teal" alt="仓库大小"></a>
</p>
<p align="center">
<a href="#-quick-start">快速开始</a> •
<a href="#-server-catalog">服务器目录</a> •
<a href="#-why-modelcontextprotocolservers">为什么选择此仓库？</a> •
<a href="#-installation">安装</a> •
<a href="#-contributing">贡献</a> •
<a href="#-documentation">文档</a>
</p>
---
## 🤔 什么是 MCP？
**模型上下文协议（MCP）** 是由 [Anthropic](https://anthropic.com) 创建的开放标准，允许 **Claude** 等 AI 模型安全地连接到外部工具、API 和数据源。MCP 服务器通过提供直接、结构化的访问权限，使 Claude 不再需要复制粘贴数据。
```
┌──────────────┐ MCP (JSON-RPC) ┌──────────────────┐ API ┌──────────────┐
│ Claude AI │ ◄────────────────────► │ MCP Server │ ◄────────────► │ GitHub API │
│ (MCP Client)│ stdio / SSE │ (from this repo)│ REST / SDK │ Notion API │
└──────────────┘ └──────────────────┘ │ Sheets API │
└──────────────┘
```
**本仓库** 是一个精选的、分类的 **生产就绪的 MCP 服务器实现** 集合，您可以在几分钟内安装并开始与 Claude Desktop、Claude Code 或任何 MCP 兼容的客户端一起使用。
---
## ⚡ 快速开始
在 **60 秒内** 启动您的第一个 MCP 服务器：
```bash
# 1. 克隆仓库
git clone https://github.com/studyhubnetin-ui/modelcontextprotocolservers.git && cd modelcontextprotocolservers
# 2. 安装服务器（例如 GitHub）
cd servers/dev-tools/github && pip install -r requirements.txt
# 3. 配置并运行 — 就是这样！
cp .env.example .env && echo "Add your GITHUB_TOKEN to .env"
```
或者使用我们的 **CLI 工具** 进行更快的设置：
```bash
npx mcp-hub-cli add github
```
然后将服务器添加到您的 **Claude Desktop** 配置文件（`claude_desktop_config.json`）：
```json
{
"mcpServers": {
"github": {
"command": "python",
"args": ["/path/to/modelcontextprotocolservers/servers/dev-tools/github/server.py"],
"env": {
"GITHUB_TOKEN": "ghp_your_token_here"
}
}
}
}
```
重启 Claude Desktop，您就可以使用了。询问 Claude： *"列出我的 GitHub 仓库"* 🎉
---
## 📦 服务器目录
每个服务器都是 **生产就绪** 的，包含完整的文档、错误处理、类型安全性和示例用法。
### 🛠️ 开发者工具
| 服务器 | 语言 | 状态 | 描述 | 文档 |
|--------|----------|--------|-------------|------|
| **[GitHub](./servers/dev-tools/github/)** | Python | ✅ 已准备好 | 管理仓库、问题、拉取请求和代码搜索。 使用 PyGithub。 | [README](./servers/dev-tools/github/README.md) |
| **[Jira](./servers/dev-tools/jira/)** | Python | 🚧 计划中 | 使用 JQL 搜索问题，创建/更新票据，管理冲刺和看板。 | [README](./servers/dev-tools/jira/README.md) |
| **[Sentry](./servers/dev-tools/sentry/)** | Python | 🚧 计划中 | 错误跟踪 - 列出问题，查看堆栈跟踪，管理发布。 | [README](./servers/dev-tools/sentry/README.md) |
### 🏭 生产力
| 服务器 | 语言 | 状态 | 描述 | 文档 |
|--------|----------|--------|-------------|------|
| **[Notion](./servers/productivity/notion/)** | Python | ✅ 已准备好 | 读取/写入页面和数据库，搜索内容，管理块。 使用 notion-client。 | [README](./servers/productivity/notion/README.md) |
| **[Linear](./servers/productivity/linear/)** | Python | 🚧 计划中 | 通过 Linear API 进行问题跟踪、项目管理和周期规划。 | [README](./servers/productivity/linear/README.md) |
| **[Todoist](./servers/productivity/todoist/)** | Python | 🚧 计划中 | 任务管理 - 创建、完成和组织任务和项目。 | [README](./servers/productivity/todoist/README.md) |
### 📊 数据与数据库
| 服务器 | 语言 | 状态 | 描述 | 文档 |
|--------|----------|--------|-------------|------|
| **[Google Sheets](./servers/data/google-sheets/)** | TypeScript | ✅ 已准备好 | 读取、写入和追加电子表格数据。 使用 googleapis。 | [README](./servers/data/google-sheets/README.md) |
| **[PostgreSQL](./servers/data/postgres/)** | Python | 🚧 计划中 | 执行只读 SQL 查询，探索模式，描述表。 | [README](./servers/data/postgres/README.md) |
| **[Airtable](./servers/data/airtable/)** | Python | 🚧 计划中 | 对基数、表和记录进行 CRUD 操作，通过 Airtable API。 | [README](./servers/data/airtable/README.md) |
### 💬 通信
| 服务器 | 语言 | 状态 | 描述 | 文档 |
|--------|----------|--------|-------------|------|
| **[Slack](./servers/communication/slack/)** | Python | 🚧 计划中 | 发送消息，搜索历史，管理频道和线程。 | [README](./servers/communication/slack/README.md) |
| **[Gmail](./servers/communication/gmail/)** | Python | 🚧 计划中 | 读取、搜索、发送电子邮件，管理标签和草稿。 | [README](./servers/communication/gmail/README.md) |
| **[Discord](./servers/communication/discord/)** | Python | 🚧 计划中 | 发送消息，管理服务器/频道，网络钩子集成。 | [README](./servers/communication/discord/README.md) |
> **图例：** ✅ 已准备好 - 完全实现和测试 | 🚧 计划中 - 欢迎贡献！
<details>
<summary><strong>🗺️ 完整路线图 — 计划 20+ 服务器</strong></summary>
我们正在积极扩展目录。即将推出的服务器包括：
| 类别 | 服务器 | 优先级 |
|----------|--------|----------|
| 开发者工具 | GitLab | 🟡 中等 |
| 开发者工具 | CircleCI | 🟡 中等 |
| 开发者工具 | Vercel | 🟢 高 |
| 生产力 | Asana | 🟡 中等 |
| 生产力 | ClickUp | 🟡 中等 |
| 生产力 | Google Calendar | 🟢 高 |
| 数据 | MongoDB | 🟢 高 |
| 数据 | Supabase | 🟢 高 |
| 数据 | BigQuery | 🟡 中等 |
| 通信 | Microsoft Teams | 🟢 高 |
| 通信 | Twilio | 🟡 中等 |
| AI / ML | Pinecone | 🟢 高 |
| AI / ML | Weaviate | 🟡 中等 |
| 云 | AWS S3 | 🟢 高 |
| 云 | Google Cloud Storage | 🟡 中等 |
| CRM | HubSpot | 🟢 高 |
| CRM | Salesforce | 🟡 中等 |
| 监控 | Datadog | 🟡 中等 |
| 监控 | PagerDuty | 🟡 中等 |
| 财务 | Stripe | 🟢 高 |
**想构建一个？** 查看 [贡献指南](./CONTRIBUTING.md) — 我们将帮助您开始！
</details>
---
## 🌟 为什么选择 MCP 服务器中心？
其他地方也有 MCP 服务器集合。以下是开发者选择本仓库的原因：
### 🏗️ 生产就绪，非概念验证
每个服务器都带有 **完整的错误处理**、**输入验证**、**类型安全性** 和 **全面的文档**。这些不是玩具示例 - 它们是为实际工作流程构建的。
### 📐 一致的架构
所有服务器都遵循 **相同的结构**，使得学习一个服务器并理解所有服务器变得微不足道：
```
servers/<category>/<name>/
├── README.md # 完整的文档和示例
├── server.py # 主要实现（或 src/index.ts）
├── .env.example # 所需环境变量
├── requirements.txt # 依赖项（或 package.json）
└── tests/ # 测试套件
```
### 🔌 即插即用
三个命令即可从零到一个可用的 Claude 集成。无需复杂的构建步骤，无需 Docker，无需配置地狱。
### 🤝 社区优先
我们积极鼓励贡献：
* 一个 [服务器模板](./docs/server-template.md) 让您在几分钟内开始
* 详细的 [贡献指南](./CONTRIBUTING.md) 包含 PR 检查清单
* 为新手提供“Good First Issue”标签
* 积极的维护者会在 24 小时内审查 PR
### 🔒 安全意识
每个服务器都遵循安全最佳实践：
* 基于环境变量的配置（无硬编码秘密）
* API 范围的最小特权
* 输入净化验证
* [安全政策](./SECURITY.md) 包含责任披露流程
### 🌍 多语言支持
选择适合您技术的语言：
* 使用官方 `mcp` SDK 和 `FastMCP` 的 **Python** 服务器
* 使用 `@modelcontextprotocol/sdk` 的 **TypeScript/Node.js** 服务器
* 相同质量标准，无论语言如何
---
## 🔧 安装
### 选项 1：CLI 工具（推荐）
从中心安装服务器的最快方法：
```bash
# 安装特定服务器
npx mcp-hub-cli add github
# 列出所有可用服务器
npx mcp-hub-cli list
# 获取服务器信息
npx mcp-hub-cli info notion
```
### 选项 2：手动安装
#### Python 服务器
```bash
# 克隆仓库
git clone https://github.com/studyhubnetin-ui/modelcontextprotocolservers.git
cd modelcontextprotocolservers
# 导航到您要的服务器
cd servers/dev-tools/github
# 创建虚拟环境（推荐）
python -m venv venv
source venv/bin/activate # 在 Windows 上：venv\Scripts\activate
# 安装依赖项
pip install -r requirements.txt
# 配置
cp .env.example .env
# 使用您的 API 密钥编辑 .env
```
#### TypeScript/Node.js 服务器
```bash
# 导航到服务器
cd servers/data/google-sheets
# 安装依赖项
npm install
# 构建
npm run build
# 配置
cp .env.example .env
# 使用您的 API 密钥编辑 .env
```
### 连接到 Claude Desktop
将服务器添加到您的 Claude Desktop 配置文件：
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
**Linux:** `~/.config/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"github": {
"command": "python",
"args": ["/absolute/path/to/servers/dev-tools/github/server.py"],
"env": {
"GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxxxx"
}
},
"notion": {
"command": "python",
"args": ["/absolute/path/to/servers/productivity/notion/server.py"],
"env": {
"NOTION_API_KEY": "secret_xxxxxxxxxxxxxxxxxxxx"
}
},
"google-sheets": {
"command": "node",
"args": ["/absolute/path/to/servers/data/google-sheets/dist/index.js"],
"env": {
"GOOGLE_SERVICE_ACCOUNT_KEY": "/path/to/service-account.json"
}
}
}
}
```
保存后重启 Claude Desktop，即可开始使用！
### 连接到 Claude Code
```bash
# 将服务器添加到 Claude Code
claude mcp add github -- python /path/to/servers/dev-tools/github/server.py
# 或使用环境变量
claude mcp add github --env GITHUB_TOKEN=ghp_xxx -- python /path/to/servers/dev-tools/github/server.py
```
---
## 📖 文档
| 文档 | 描述 |
|----------|-------------|
| [🏗️ 架构概述](./docs/architecture.md) | MCP 工作原理、协议详情和服务器生命周期 |
| [🚀 设置指南](./docs/setup.md) | 分步指南，帮助您启动第一个服务器 |
| [📝 服务器模板](./docs/server-template.md) | 新 MCP 服务器的样板代码 |
| [📚 示例](./examples/) | 实际使用场景和 Claude Desktop 配置 |
| [🤝 贡献指南](./CONTRIBUTING.md) | 如何添加新服务器或改进现有服务器 |
| [🔒 安全政策](./SECURITY.md) | 漏洞报告和安全最佳实践 |
---
## 💡 使用示例
一旦您将服务器连接到 Claude，以下是您可以执行的操作：
### GitHub 服务器
```
您： “列出我的存储库中标记为‘bug’的所有打开问题”
您： “创建一个新问题，标题为‘修复登录重定向’，并附上详细描述”
您： “显示我最近的 5 个拉取请求及其审查状态”
您： “在我的组织仓库中搜索包含‘已弃用 API’的文件”
```
### Notion 服务器
```
您： “查找我的工作区中所有提及‘Q4 规划’的页面”
您： “在我的项目数据库中创建一个新页面，状态为‘进行中’”
您： “读取我的‘会议笔记’页面的内容并总结它”
您： “向我的任务跟踪器数据库添加新行”
```
### Google Sheets 服务器
```
您： “从 Sheet1 读取数据，范围 A1:F50”
您： “在我的跟踪电子表格中追加一行今日的指标”
您： “创建一个名为‘Q1 报告’的新表格并添加表头”
您： “将预算表格中的单元格 B5 更新为 15000”
```
### 多服务器工作流
```
您： “对于标记为‘紧急’的 GitHub 问题，为每个问题创建 Notion 任务并添加一行到 Google Sheets 跟踪器”
您： “读取今天的 Notion 会议笔记，为每个行动项创建 GitHub 问题，并将它们记录在电子表格中”
```
---
## 🤝 贡献
我们欢迎来自所有人的贡献！无论您是添加新服务器、修复错误还是改进文档，每一份贡献都对社区有帮助。
### 快速贡献指南
1. **复刻** 仓库
2. **选择一个服务器** 从 [路线图](#-server-catalog) 或 [开放问题](https://github.com/studyhubnetin-ui/modelcontextprotocolservers/issues)
3. **使用模板** 从 [`docs/server-template.md`](./docs/server-template.md)
4. **遵循检查清单** 在 [`CONTRIBUTING.md`](./CONTRIBUTING.md)
5. **打开 PR** — 我们在 24 小时内审查
### 贡献方式
| 贡献 | 难度 | 影响 |
|--------------|-----------|--------|
| ⭐ 给仓库点赞 | 初学者 | 帮助我们接触更多开发者 |
| 🐛 报告错误 | 初学者 | 提高可靠性 |
| 📖 改进文档 | 初学者 | 使 onboarding 更容易 |
| 🔌 添加新服务器 | 中级 | 扩展生态系统 |
| 🧪 添加测试 | 中级 | 增加稳定性 |
| 🏗️ 改进架构 | 高级 | 造福所有服务器 |
> **第一次为开源做贡献？** 查找标有 [`good first issue`](https://github.com/studyhubnetin-ui/modelcontextprotocolservers/labels/good%20first%20issue) 的问题 — 我们将帮助您完成第一个 PR！
查看完整的 [贡献指南](./CONTRIBUTING.md) 获取详细说明。
---
## 📊 项目统计
### 星历史
<p align="center">
<a href="https://star-history.com/#studyhubnetin-ui/modelcontextprotocolservers&Date">
<img src="https://api.star-history.com/svg?repos=studyhubnetin-ui/modelcontextprotocolservers&type=Date" alt="星历史图" width="600" />
</a>
</p>
### 贡献者
<p align="center">
<a href="https://github.com/studyhubnetin-ui/modelcontextprotocolservers/graphs/contributors">
<img src="https://contrib.rocks/image?repo=studyhubnetin-ui/modelcontextprotocolservers" alt="贡献者" />
</a>
</p>
---
## 🗂️ 仓库结构
```
modelcontextprotocolservers/
├── servers/ # 所有 MCP 服务器实现
│ ├── productivity/ # Notion, Linear, Todoist
│ ├── dev-tools/ # GitHub, Jira, Sentry
│ ├── data/ # Google Sheets, PostgreSQL, Airtable
│ └── communication/ # Slack, Gmail, Discord
├── docs/ # 指南和架构文档
│ ├── architecture.md # MCP 工作原理
│ ├── setup.md # 入门指南
│ └── server-template.md # 新服务器的样板代码
├── examples/ # 使用示例和配置
├── CONTRIBUTING.md # 如何贡献
├── CODE_OF_CONDUCT.md # 社区标准
├── SECURITY.md # 安全政策
├── LICENSE # MIT 许可证
└── README.md # 你在这里！
```
---
## 🔗 相关资源
- [模型上下文协议规范](https://spec.modelcontextprotocol.io/) — 官方MCP规范
- [Anthropic MCP 文档](https://docs.anthropic.com/en/docs/agents-and-tools/mcp) — Anthropic的MCP文档
- [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) — 官方Python SDK
- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) — 官方TypeScript SDK
- [Claude 桌面版](https://claude.ai/download) — 下载Claude桌面版（支持MCP）
- [Claude 代码](https://docs.anthropic.com/en/docs/claude-code) — Claude的代码代理，支持MCP
---
## ❓ 常见问题
<details>
<summary><strong>什么是模型上下文协议（MCP）？</strong></summary>
MCP是由Anthropic开发的开放协议，它标准化了像Claude这样的AI助手如何连接到外部数据源和工具。它使用JSON-RPC 2.0协议，通过stdio或SSE传输。可以把它想象成“AI的USB-C接口”——Claude和您的工具之间的通用连接器。
</details>
<details>
<summary><strong>使用这些服务器需要Claude桌面版吗？</strong></summary>
Claude桌面版是最常见的方式，但MCP服务器与任何支持MCP的客户端兼容，包括Claude Code、Cline、Continue和其他支持该协议的IDE扩展。
</details>
<details>
<summary><strong>这些服务器安全吗？</strong></summary>
是的。所有服务器都使用环境变量存储凭证（从不硬编码），验证所有输入，遵循最小特权原则，并经过代码审查。有关详细信息，请参见我们的[安全政策](./SECURITY.md)。
</details>
<details>
<summary><strong>我可以同时使用多个服务器吗？</strong></summary>
绝对可以！Claude可以同时连接到多个MCP服务器。这就是它的强大之处——您可以协调跨平台的工作流程，例如“在GitHub上创建一个问题，在Notion中添加它，并在Google Sheets中记录它”，所有这些都可以在一次对话中完成。
</details>
<details>
<summary><strong>如何添加我自己的服务器？</strong></summary>
请查看我们的[服务器模板](./docs/server-template.md)以获取样板代码，并查看[贡献指南](./CONTRIBUTING.md)以获取完整流程。我们在24小时内审核所有拉取请求！
</details>
<details>
<summary><strong>MCP工具和Claude的内置工具有什么区别？</strong></summary>
Claude的内置工具（如网络搜索）由Anthropic提供。MCP服务器允许您添加**您自己的自定义工具**——将Claude连接到您特定的API、数据库和内部服务。MCP是使Claude可扩展的协议。
</details>
---
## 📄 许可证
该项目在 **MIT License** 下获得许可 — 有关详细信息，请参见 [LICENSE](./LICENSE) 文件。
您可以自由使用、修改和分发这些服务器用于您自己的项目，无论是个人还是商业项目。
---
## 🙏 致谢
- [Anthropic](https://anthropic.com) 创建了Claude和模型上下文协议
- [MCP社区](https://github.com/modelcontextprotocol) 提供了官方SDK
- 所有 [贡献者](https://github.com/studyhubnetin-ui/modelcontextprotocolservers/graphs/contributors) 都帮助使该项目变得更好
---
<p align="center">
<strong>如果这个项目对您有帮助，请考虑给它一个 ⭐</strong><br>
它帮助其他人发现该项目，并激励继续开发。
</p>
<p align="center">
<a href="https://github.com/studyhubnetin-ui/modelcontextprotocolservers/stargazers">
<img src="https://img.shields.io/github/stars/studyhubnetin-ui/modelcontextprotocolservers?style=social" alt="在GitHub上点赞">
</a>
</p>
<p align="center">
由开源社区 ❤️ 构建<br>
<sub>Claude MCP • 模型上下文协议服务器 • Anthropic Claude集成 • Claude AI代理 • AI工作流程自动化</sub>
</p>
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器