AI导哈

AI助手服务集成套件

一个集成了多种服务和API的MCP服务器集合，旨在增强AI助手的功能，适用于开发者和AI助手用户。

  • by shigennn
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 shigennn/mcp-server-collection

使用说明

MCP服务器集合

一组模型上下文协议（MCP）服务器，旨在将各种服务和API与AI助手集成。 该项目提供了一个全面的MCP服务器中心，可以通过模型上下文协议增强Claude Desktop、Cursor、GitHub Copilot等人工智能助手。

概述

该项目实现了几个MCP服务器，这些服务器提供与各种服务的集成：

  • 勇敢的搜索：使用Brave search API的Web搜索和本地搜索功能
  • 文件系统：具有安全限制的文件系统操作
  • Git：Git存储库管理功能
  • GitHub：用于存储库、问题、拉取请求等的GitHub API集成
  • 外壳：在受控环境中执行Shell命令
  • Figma：与Figma API集成，用于设计文件
  • Slack：用于消息传递和渠道信息的Slack API集成
  • 萤火虫：Web抓取功能
  • 概念：注意API与降价转换的集成，以提高可读性
  • 思考：用于解决复杂问题的结构化推理空间（仅限Claude Desktop）

需求

  • Node.js （v18+）
  • 包子 作为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助手一起使用，您需要根据您的助手进行配置：

  • 克劳德桌面：

    1. 打开克劳德桌面
    2. 点击菜单栏并选择“设置”
    3. 导航到“MCP”部分以配置您的服务器

  • 光标：

    • MCP服务器可以通过Cursor的设置菜单进行配置：
      1. 打开光标设置
      2. 导航到“功能>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 文件以避免错误。

API密钥和令牌设置

对于每个服务集成，您需要获得并配置适当的API密钥：

  1. 勇敢搜索API：注册地址： 勇敢搜索API 获取API密钥
  2. GitHub：创建一个 个人访问令牌 具有适当的权限
  3. Figma：生成 访问令牌 在您的Figma帐户中
  4. Slack：创建一个 Slack应用程序 并生成bot令牌
  5. 萤火虫：注册Firecrawl API密钥
  6. 概念：创建一个 整合 并获取API密钥

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

用法

  1. 启动您的AI助手
  2. 根据助手的要求配置MCP服务器
  3. 助理现在可以在您的对话中访问所有集成服务

功能详细信息

概念整合

Notion集成提供：

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

GitHub集成

GitHub集成支持：

  • 存储库创建、搜索和管理
  • 文件检索、更新和提交
  • 发布和拉取请求管理
  • 多账户支持

文件系统

通过以下方式安全访问文件系统：

  • 文件读写操作
  • 目录操作
  • 文件搜索功能
  • 文件元数据检索

其他集成

  • 勇敢的搜索：网络和本地搜索功能
  • Git：存储库管理、提交、分支操作
  • 外壳：受控shell命令执行
  • Figma：设计文件检索和操作
  • Slack：消息发送和频道信息检索
  • 萤火虫：网页抓取
  • 概念：API集成理念

思考整合

Think集成提供：

  • 复杂问题求解的结构化推理空间
  • 能够将问题分解为可管理的步骤
  • 支持有条不紊的思考和分析，而无需执行行动
  • 通过引导性思维过程改进决策

备注：Think工具与Claude Desktop完全兼容，无法在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/：API集成理念
  • src/think.ts：用于解决复杂问题的结构化推理空间

要添加新功能，请执行以下操作：

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

安全考虑

  • 文件系统和shell服务器包括防止未经授权访问的安全措施
  • 执行命令前始终验证用户输入
  • 配置允许文件系统访问的目录时要小心
  • 使用shell服务器的allowlist命令限制可执行命令
  • 安全地存储API密钥和令牌，并遵循最低权限原则

参考文献和致谢

此项目基于以下存储库：

其他参考文献：

许可证

MIT许可证

相关 MCP