MCP Server Collection

🚀 MCP 服务器集合

本项目是一个集成多种服务和 API 的模型上下文协议 (MCP) 服务器集合，旨在增强 AI 助手（如 Claude Desktop、Cursor、GitHub Copilot 等）的功能，为其提供更丰富的服务支持。

🚀 快速开始

此项目实现了多个 MCP 服务器，支持多种服务的集成，包括网络搜索、文件系统管理、版本控制、设计资源操作等，为 AI 助手提供了强大的功能扩展。

✨ 主要特性

• 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 前，查阅贡献者文档以获取更多细节。