MCP 服务器集合

一个集成多种服务和 API 的模型上下文协议 (MCP) 服务器集合，旨在增强 AI 助手的功能，例如 Claude Desktop、Cursor、GitHub Copilot 等。

概述

此项目实现了多个 MCP 服务器，支持以下服务的集成：

• Brave Search: 使用 Brave Search API 提供网络搜索功能
• 文件系统: 管理本地文件和目录操作
• Git: 执行 Git 版本控制操作
• GitHub: 与 GitHub 仓库进行交互
• Shell: 在终端中执行命令
• Figma: 操作 Figma 设计资源
• Slack: 与 Slack 进行通信
• Firecrawl: 进行网络爬虫任务
• Notion: 操作 Notion 工作空间中的数据
• Think: 提供复杂问题的结构化推理环境

安装指南

1. 克隆此仓库到本地：

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

2. 安装依赖项：

   npm install
   

3. 启动 MCP 服务器：

   • 对于开发环境，请运行 npm run dev。
   • 对于生产环境，请使用 PM2 管理进程。

配置说明

每个 MCP 服务器的配置位于项目的 config 目录中。请根据您的需求修改以下内容：

• API 密钥: 在 secrets.json 中添加所有必要的 API 凭据。
• 允许目录: 在 filesystem.json 中指定文件系统操作的授权路径。
• 命令白名单: 在 shell.json 中定义允许执行的 Shell 命令。

使用方法

1. 将 MCP 服务器添加到您的 AI 助手配置中：

   {
     "servers": [
       { "name": "brave-search", "url": "http://localhost:3000" },
       { "name": "filesystem", "url": "http://localhost:3001" },
       // 添加其他服务器配置
     ]
   }
   

2. 在您的 AI 助手代码中引入所需模块：

   import { FileSystem } from './src/filesystem';
   const fs = new FileSystem();
   

功能细节

文件系统

• 读取文件: 获取指定路径下的文件内容。
• 写入文件: 创建或覆盖文件，写入新内容。
• 列出目录: 返回指定目录中的所有文件和子目录。
• 删除操作: 删除文件或空目录。

Git 操作

• 克隆仓库: 从远程 URL 克隆 Git 仓库到本地。
• 提交更改: 将修改后的文件提交到当前分支。
• 切换分支: 在不同的 Git 分支之间进行切换。
• 拉取更新: 从远程仓库获取最新代码并合并到当前分支。

GitHub 集成

• 创建新仓库: 使用 API 创建新的 GitHub 仓库。
• ** Fork 仓库**: 创建现有仓库的 Fork。
• ** 提交更改**: 将本地修改推送到指定的远程仓库。
• ** 获取仓库信息**: 检索特定仓库的详细信息，包括贡献者和分支。

Shell 命令

• 执行命令: 在终端中运行用户提供的命令。
• 获取输出: 返回命令的标准输出、错误输出及退出状态码。
• 文件操作: 支持重命名、删除和创建新文件或目录。

Figma 设计

• 创建页面: 在 Figma 项目中添加新的设计页面。
• ** 获取组件**: 检索特定组件的详细信息，包括其属性和版本历史。
• ** 更新布局**: 修改页面中的元素位置和大小。
• ** 导出资源**: 将选定的设计资产导出为多种格式。

Slack 通信

• ** 发送消息**: 向指定频道发送文本或 Markdown 格式的消息。
• ** 获取聊天记录**: 检索特定时间段内的聊天历史。
• ** 添加附件**: 上传文件并附在消息中发送。
• ** 直接消息**: 向特定用户发送私信。

网络爬虫

• 启动爬虫: 使用指定的 URL 初始化爬虫任务。
• ** 获取结果**: 检索爬取到的数据，包括 HTML 内容和链接。
• ** 设置规则**: 定义爬虫的行为，如抓取深度和排除特定 URL。
• ** 中止任务**: 在任何时间点停止当前进行的爬虫任务。

Notion 工作空间

• ** 创建页面**: 添加新的 Notion 页面或数据库条目。
• ** 获取内容**: 检索指定页面或数据库中的所有记录。
• ** 更新信息**: 修改现有页面或数据库条目的内容和属性。
• ** 删除数据**: 从工作区中删除不再需要的内容。

复杂问题推理

• ** 提交查询**: 将复杂的问题分解为多个子任务，逐一分析解决。
• ** 获取中间结果**: 在推理过程中获取每个步骤的输出。
• ** 最终答案**: 返回经过验证的最终结论和相关支持证据。

安全注意事项

1. 权限管理: 严格限制 API 的访问权限，避免未授权操作。
2. ** 输入过滤**: 对用户提供的输入进行严格的验证和消毒处理，防止注入攻击。
3. ** 日志记录**: 记录所有敏感操作日志，便于审计和问题排查。

常见问题

1. 如何处理大文件上传？

   • 使用分块上传机制，并设置适当的超时策略。

2. 遇到 Git 操作失败怎么办？

   • 检查网络连接和仓库权限，确保所有凭据正确配置。

3. 怎样提高性能？

   • 优化数据库查询，减少不必要的网络请求。

贡献指南

1. 提交代码前，请确保通过单元测试。
2. 遵循项目编码规范，保持代码风格一致。
3. 在提交 Pull Request 前，查阅贡献者文档以获取更多细节。