AI导哈

模型上下文协议服务器集合

一个精选的模型上下文协议（MCP）服务器集合，用于与Cursor等AI开发工具无缝集成，实现强大的上下文感知编码体验。

  • by Ahmet-Ruchan
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Ahmet-Ruchan/MCP

使用说明

🚀 MCP服务器集合

精心策划的收藏 模型上下文协议（MCP） 服务器与Cursor等人工智能开发工具无缝集成，实现强大的上下文感知编码体验。

📖 目录

🤔 什么是MCP？

模型上下文协议（MCP） 是一个开放协议，规范了应用程序如何向大型语言模型（LLM）提供上下文。它使AI助手能够以受控的方式安全地访问外部工具、API和数据源。

主要优势：

  • 🔌 通用集成：将AI模型连接到任何数据源或工具
  • 🔒 安全访问：外部资源的细粒度权限控制
  • ⚡ 实时数据：从API和数据库访问最新信息
  • 🛠️ 可扩展：根据您的特定需求构建自定义服务器
  • 🌐 跨平台：适用于多种AI开发环境

✨ 特性

  • GitHub集成：通过MCP完全访问GitHub API
  • 易于配置：基于JSON的简单设置
  • 许可证管理：安全的凭证处理
  • 多服务器支持：同时运行多个MCP服务器
  • 实时更新：从外部源访问实时数据
  • 错误处理：强大的错误报告和调试

🛠️ 可用的MCP服务器

此存储库包括以下MCP服务器的配置和示例：

1.MCP发生器⚡ 新

生成其他MCP服务器的元MCP服务器！

MCP生成器是一个革命性的工具，可以自动创建MCP服务器。不要手动编写样板代码，只需描述您想要什么，生成器就会为您创建一个完整的、可用于生产的MCP服务器。

能力：

  • 🏗️ 从模板生成完整的MCP服务器
  • 🛠️ 支持基于工具、基于资源和功能齐全的服务器
  • 📝 自动创建文件结构（server.py、README.md、requirements.txt）
  • ✅ 内置配置验证
  • 📚 快速启动的示例配置
  • 🎯 通过AI助手生成交互式代码

使用案例：

  • MCP服务器的快速原型制作
  • 学习MCP协议最佳实践
  • 自动化重复的服务器设置
  • 快速创建自定义集成

地点： mcp-generator/

文档： 看 mcp生成器/README.md 了解详细的使用说明。

2.GitHub MCP服务器

将您的AI助手直接连接到GitHub，以进行存储库管理、问题跟踪和代码协作。

能力：

  • 📦 创建、更新和管理存储库
  • 🔍 搜索代码、问题和用户
  • 📝 创建和管理问题并拉取请求
  • 🌿 分行管理和档案操作
  • 👥 存储库协作功能
  • 📊 访问存储库统计数据和见解

包裹： @modelcontextprotocol/server-github

3.计算器服务器（示例）

MCP Generator生成的演示MCP服务器，展示基本的数学运算。

能力：

  • ➕ 加法和减法
  • ✖️ 乘法和除法
  • 📊 动力操作

地点： test-output/calculator-server/ （生成示例）

马上就来：

现在，您可以使用MCP生成器自己生成这些！

  • 文件系统MCP服务器 -本地文件系统访问
  • 数据库MCP服务器 -SQL数据库集成
  • API MCP服务器 -自定义REST API连接
  • 云存储MCP服务器 -S3、GCS、Azure Blob集成
  • 自定义服务器 -使用MCP生成器创建您需要的任何服务器！

📦 安装

先决条件

  • Python 3.10+（用于MCP生成器和基于Python的服务器）
  • Node.js（v18或更高版本）（适用于GitHub MCP服务器）
  • npm或yarn（适用于GitHub MCP服务器）
  • 支持MCP的AI开发工具（例如Cursor、Claude Code）
  • GitHub个人访问令牌（适用于GitHub MCP服务器）

设置步骤

  1. 克隆此存储库：

    git clone https://github.com/Ahmet-Ruchan/MCP.git
cd MCP

  2. 安装MCP发电机（推荐）：

    cd mcp-generator
pip install -r requirements.txt
cd ..

  3. 获取您的GitHub个人访问令牌（适用于GitHub服务器）：

    • 转到GitHub设置→ 开发者设置→ 个人访问令牌→ 代币（经典）
    • 生成具有所需作用域的新令牌： repo, read:user, user:email
    • 复制令牌以进行配置

  4. 在游标/克劳德代码中配置MCP：

    编辑或创建 ~/.cursor/mcp.json 或 ~/.config/claude-code/mcp.json:

    {
  "mcpServers": {
    "mcp-generator": {
      "command": "python",
      "args": [
        "/absolute/path/to/MCP/mcp-generator/server.py"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token_here"
      }
    }
  }
}

    注： 替换 /absolute/path/to/MCP 使用克隆此存储库的实际路径。

  5. 清除npx缓存（如果GitHub服务器需要）：

    rm -rf ~/.npm/_npx

  6. 重新启动游标/Claude代码

⚙️ 配置

GitHub MCP服务器配置

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

重要提示：

  • ⚠️ 永远不要将您的实际令牌提交给版本控制
  • ⚠️ 移除 < 和 > 标记中的括号-仅使用原始标记值
  • ⚠️ 确保令牌具有用于预期操作的适当权限

环境变量

变量 描述 必填
GITHUB_PERSONAL_ACCESS_TOKEN 用于API访问的GitHub PAT 是

🎯 用法示例

使用MCP发生器

示例1：生成计算器服务器

// Ask your AI assistant:
"Use the mcp-generator to create a calculator server with add, subtract, multiply, and divide tools"

// The generator will:
// 1. Create a complete server structure
// 2. Generate all necessary files
// 3. Provide installation instructions

示例2：生成Weather API服务器

// Ask your AI assistant:
"Generate a full MCP server for weather data with a search tool, current weather resource, and a forecast analysis prompt"

示例3：生成前验证

// Ask your AI assistant:
"Validate this MCP config before generating: {your config here}"

使用GitHub MCP服务器

示例4：创建存储库

// Using MCP in Cursor, you can ask:
"Create a new GitHub repository called 'my-awesome-project' with a description"

示例5：搜索存储库

// Find repositories:
"Search for my repositories related to machine learning"

示例6：管理问题

// Create and manage issues:
"Create an issue in my repository about adding authentication"

示例7：推送文件

// Push files to repository:
"Push these files to my GitHub repository"

🐛 故障排除

常见问题

1.“ERR_MODULE_NOT_FOUND”错误

# Solution: Clear npx cache
rm -rf ~/.npm/_npx

2.“凭据错误”错误

  • 检查令牌是否正确且格式正确（否 <> 括号）
  • 验证令牌是否具有所需权限
  • 如果令牌过期，则重新生成令牌

3.“未找到服务器信息”错误

  • 完全重新启动游标
  • 检查 mcp.json 语法
  • 验证命令和参数是否正确

4.包装弃用警告

npm warn deprecated @modelcontextprotocol/server-github
  • 这是意料之中的——该软件包可以工作，但可能有更新的替代方案
  • 除非出现关键问题，否则继续使用

调试模式

要在Cursor中查看详细的MCP日志：

  1. 打开游标日志： Help → Show Logs
  2. 查找与MCP相关的条目
  3. 检查连接和身份验证问题

🤝 贡献

欢迎投稿！请随意：

  • 🐛 报告错误
  • 💡 建议新的MCP服务器集成
  • 📝 改进文档
  • 🔧 提交拉取请求

如何贡献

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/AmazingFeature)
  3. 提交您的更改(git commit -m 'Add some AmazingFeature')
  4. 推到分支(git push origin feature/AmazingFeature)
  5. 打开拉取请求

📚 资源

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

  • Anthropic 用于开发MCP协议
  • 光标 用于MCP集成支持
  • MCP服务器实现的开源社区

📞 联系

艾哈迈德 Ruchhan 猎人

⭐ 如果你觉得这个存储库有用，请考虑给它一颗星！

由以下材料制成❤️ 使用MCP

相关 MCP