MCP Server Collection

一个模型上下文协议 (MCP) 服务器的集合，旨在将各种服务和 API 与 AI 助手集成。 本项目提供了一个全面的 MCP 服务器中心，可以通过模型上下文协议增强 AI 助手，例如 Claude Desktop、Cursor、GitHub Copilot 等。

概述

本项目实现了多个 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
   

配置

要将这些 MCP 服务器与您的 AI 助手一起使用，您需要根据您的助手进行配置：

• Claude Desktop:

  1. 打开 Claude Desktop
  2. 点击菜单栏并选择“Settings”
  3. 导航到“MCP”部分以配置您的服务器

• Cursor:

  • MCP 服务器可以通过 Cursor 的 Settings 菜单进行配置：
    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 服务器都作为 src 文件夹中的独立 TypeScript 文件或目录实现：

• 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