MCP Server Collection

MCP 服务集合

这是一个 Model Context Protocol（MCP）服务集合，旨在将各种服务和 API 集成到 AI 助手中。 本项目提供了一个全面的 MCP 服务中心，可通过 Model Context Protocol 增强 Claude Desktop、Cursor、GitHub Copilot 等 AI 助手。

概览

本项目实现了多个可与各种服务集成的 MCP 服务：

• Brave Search：使用 Brave Search API 提供网页搜索和本地搜索功能
• Filesystem：提供带有安全限制的文件系统操作
• Git：提供 Git 仓库管理功能
• GitHub：集成 GitHub API，支持仓库、问题、拉取请求等
• Shell：在受控环境中执行 Shell 命令
• Figma：集成 Figma API，支持设计文件
• Slack：集成 Slack API，支持消息和频道信息
• Firecrawl：提供网页抓取功能
• Notion：集成 Notion API，并支持 Markdown 转换以提升可读性
• Think：为复杂问题解决提供结构化推理空间（仅限 Claude Desktop）

要求

• Node.js（v18+）
• 将 Bun 用作 JavaScript/TypeScript 运行时
• 支持 MCP 的 AI 助手（例如 Claude Desktop、Cursor、GitHub Copilot）

安装

1. 克隆仓库：

   git clone https://github.com/shigennn/mcp-server-collection.git
   cd mcp-server-collection
   

2. 安装依赖：

   bun install
   

配置

若要在 AI 助手中使用这些 MCP 服务，需要根据所用助手进行配置：

• Claude Desktop：

  1. 打开 Claude Desktop
  2. 点击菜单栏并选择“Settings”
  3. 前往“MCP”部分配置服务

• Cursor：

  • 可通过 Cursor 的 Settings 菜单配置 MCP 服务：
    1. 打开 Cursor Settings
    2. 前往“Features > MCP”
    3. 添加服务配置

此仓库在 config_templates 目录中包含配置模板：

• claude_desktop_config_template.json：Claude Desktop 的完整配置

使用模板：

1. 从 config_templates 目录复制相应模板
2. 将 <YOUR_USERNAME> 和 <path> 占位符替换为实际值
3. 在需要的位置添加 API 密钥和令牌
4. 将配置导入或粘贴到 AI 助手的设置中

注意：Windows 路径使用反斜杠（\\），macOS 或 Linux 使用正斜杠。

Cursor 用户须知：Think 工具仅兼容 Claude Desktop。如果使用 Cursor，请从 mcp.json 文件中移除 Think 配置，以避免错误。

API 密钥和令牌设置

对于每项服务集成，都需要获取并配置相应的 API 密钥：

1. Brave Search API：在 Brave Search API 注册以获取 API 密钥
2. GitHub：创建具有适当权限的个人访问令牌
3. Figma：在 Figma 账户中生成访问令牌
4. Slack：创建 Slack 应用并生成机器人令牌
5. Firecrawl：注册以获取 Firecrawl API 密钥
6. Notion：创建集成并获取 API 密钥

将配置文件中的占位值替换为实际的 API 密钥和令牌。

使用方法

1. 启动 AI 助手
2. 根据助手的要求配置 MCP 服务
3. 此后，助手便可在对话中访问所有已集成的服务

功能详情

Notion 集成

Notion 集成提供以下功能：

• 创建、获取、更新和删除页面、数据库和块
• 搜索功能
• Markdown 转换，以提升可读性
• 数据库查询功能
• 评论功能

GitHub 集成

GitHub 集成支持：

• 创建、搜索和管理仓库
• 获取、更新和提交文件
• 管理问题和拉取请求
• 支持多个账户

文件系统

安全访问文件系统，支持：

• 读取和写入文件
• 目录操作
• 搜索文件
• 获取文件元数据

其他集成

• Brave Search：网页和本地搜索功能
• Git：仓库管理、提交和分支操作
• Shell：受控的 Shell 命令执行
• Figma：获取和操作设计文件
• Slack：发送消息和获取频道信息
• Firecrawl：网页抓取
• Notion：Notion API 集成

Think 集成

Think 集成提供：

• 为复杂问题解决提供结构化推理空间
• 将问题拆解为易于处理的步骤
• 支持有条理地思考和分析，而不执行操作
• 通过引导式思考流程改善决策

注意：Think 工具仅兼容 Claude Desktop，无法在 Cursor 或其他环境中运行。Cursor 用户不应将此工具加入配置。

开发

每个 MCP 服务都以独立的 TypeScript 文件或目录形式实现在 src 文件夹中：

• src/brave-search.ts：Brave Search API 集成
• src/filesystem.ts：文件系统操作
• src/git.ts：Git 操作
• src/github.ts 和 src/github/：GitHub API 集成
• src/shell.ts：Shell 命令执行
• src/figma.ts：Figma API 集成
• src/slack.ts：Slack API 集成
• src/firecrawl.ts：网页抓取
• src/notion.ts 和 src/notion/：Notion API 集成
• src/think.ts：用于解决复杂问题的结构化推理空间

添加新功能：

1. 在 src 目录中创建新的 TypeScript 文件
2. 使用 @modelcontextprotocol/sdk 实现 MCP 服务
3. 将新服务添加到 AI 助手的配置中

安全注意事项

• 文件系统和 Shell 服务包含防止未授权访问的安全措施
• 执行命令前，始终验证用户输入
• 配置文件系统的允许访问目录时，请谨慎操作
• 使用 Shell 服务的命令允许列表限制可执行的命令
• 安全存储 API 密钥和令牌，并遵循最小权限原则

参考资料与致谢

本项目基于以下仓库：

• ukkz/claude-ts-mcps - MCP 服务集合的原始实现
• suekou/mcp-notion-server - Notion MCP 服务的参考实现

其他参考资料：

• Model Context Protocol
• MCP Server Quickstart

许可证

MIT License