使用说明
🚀 MCP示例中心：您的模型上下文协议网关
欢迎来到 MCP示例中心！此存储库是一组精心策划的模型上下文协议（MCP）服务器，旨在扩展AI助手（如Claude、ChatGPT或本地代理）的功能。
模型上下文协议（MCP）允许AI模型与您的本地工具、数据库和API安全、结构化地交互。
📁 存储库概述
该项目包含6个不同的MCP服务器示例，从简单的计算器到复杂的企业集成。
| # | 示例 | 描述 | 技术 |
|---|---|---|---|
| 1 | 基本设置 | 使用投影计算器的“Hello World”风格设置。 | Python/Gradio |
| 2 | Kubernetes（kubectl） | 直接从AI界面管理K8s集群。 | Python/Docker |
| 3 | Google Workspace | 与Gmail（发送/搜索）和谷歌日历交互。 | Node.js/谷歌API |
| 4 | excel自动化 | 查询和操作Excel电子表格数据。python | |
| 5 | PowerPoint创建器 | 基于人工智能生成的内容生成演示文稿。 | Python/UV |
| 6 | YouTube见解 | 搜索视频并获取频道记录/数据。 | Node.js/YouTube API |
| 7 | 困惑搜索 | 高质量的实时网络搜索。 | Python/困惑API |
🛠️ 一般先决条件
在开始之前，请确保已安装以下内容：
- Node.js （v18+）和 npm
- python （v3.10+）
- 克劳德桌面 或等效的MCP兼容客户端
- 码头工人 （仅适用于示例2）
🚀 快速入门指南
1.MCP服务器的基本结构
此仓库中的大多数示例都遵循类似的设置：
- 配置环境：设置API密钥或本地权限。
- 启动服务器：运行服务器脚本（通常
app.py或index.js). - 配置客户端：将服务器的端点添加到AI客户端的配置文件中。
2.配置您的AI客户端
要将这些服务器与Claude Desktop应用程序一起使用，您需要编辑配置文件：
地点：
- 窗户：
%APPDATA%\Claude\claude_desktop_config.json - macOS：
~/Library/Application Support/Claude/claude_desktop_config.json
示例条目：
{
"mcpServers": {
"my-example-server": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-everything"]
}
}
}
🤝 社区与贡献
我们认为MCP的力量在于社区驱动的工具。我们邀请您：
- ⭐ 明星回购：如果你觉得这些例子有用！
- 🍴 分叉与构建：将这些用作您自己的自定义服务器的蓝图。
- 🙋 打开问题：如果你遇到了一个障碍，或者对一个新的例子有一个好主意。
- 🚀 提交PR：我们喜欢看到新的集成（例如Salesforce、Slack、Perplexity等）。
如何贡献一个新的例子
- 创建一个前缀为下一个逻辑号的新目录（例如。，
7-my-new-server). - 包括a
README.md在该文件夹中包含安装说明。 - 确保未提交任何敏感信息（API密钥、个人文件路径）。
🔒 安全与隐私
这些例子是出于教育目的。永远记住：
- 永远不要承诺你的
credentials.json,.env文件或API密钥。 - 请注意您授予MCP服务器的权限（特别是文件系统或电子邮件访问权限）。
由社区为社区而建。 让我们让人工智能更有用，一次一个工具。
