使用说明

项目简介

claude-mcp-setup 是一个用于快速部署和配置多个 Model Context Protocol (MCP) 服务器的工具仓库。它通过自动化安装、配置 API 密钥和更新 Claude 桌面应用配置，帮助用户轻松集成各种功能强大的 MCP 服务器到 Claude 等 LLM 客户端中。该仓库的核心是一个 Python 脚本 'mcp_setup.py'，它可以安装并配置一系列预定义的 MCP 服务器，涵盖文件系统访问、GitHub 集成、搜索引擎、内存存储、RAG 检索增强生成等多种能力。

主要功能点

自动化安装 MCP 服务器: 一键安装多个流行的 MCP 服务器，包括 '@modelcontextprotocol' 和 '@patruff' 组织维护的服务器。
API 密钥管理: 支持通过 '.env' 文件或命令行交互式输入 API 密钥，方便管理和配置不同 MCP 服务器所需的认证信息。
Claude 应用配置: 自动更新 Claude 桌面应用的配置文件 'claude_desktop_config.json'，注册和配置已安装的 MCP 服务器，使得 Claude 可以直接使用这些服务器提供的功能。
支持多种 MCP 服务器: 集成了文件系统、GitHub、Brave Search、内存、任务管理 (Todoist)、RAG 数据库 (LightRAG)、代码片段编辑等多种 MCP 服务器。
Gmail 和 Google Drive 集成: 特别支持 Gmail 和 Google Drive MCP 服务器的配置，包括 Google Cloud 项目设置、OAuth 认证流程自动化。

安装步骤

环境准备:
- 确保已安装 Python 3.x 和 Node.js 环境。
- （可选）拥有 Google Cloud 账户，如果需要使用 Gmail/Drive MCP 服务器。
- （可选）准备好各种 API 密钥，例如 GitHub PAT、Replicate API Token、Brave Search API Key、Todoist API Token 等，具体取决于您需要安装的 MCP 服务器。
下载仓库:
- 克隆 'claude-mcp-setup' 仓库到本地。
配置 API 密钥 (可选):
- 在仓库根目录下创建 '.env' 文件，并根据 'README.md' 中的 '.env' 文件示例，填入您的 API 密钥。或者在运行脚本时，根据提示输入。
运行安装脚本:
- 打开命令行终端，进入仓库根目录。
- 运行命令 'python mcp_setup.py'。
- 脚本将自动安装指定的 npm 和 Python 包，并根据配置更新 Claude 的 'claude_desktop_config.json' 文件。
- 如果需要配置 Gmail/Drive MCP 服务器，请按照脚本提示完成 Google Cloud 的 OAuth 认证流程。

服务器配置

'mcp_setup.py' 脚本会自动更新 Claude 的配置文件 'claude_desktop_config.json'，以下是一个配置示例，展示了部分 MCP 服务器的配置信息：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-filesystem", "/path/to/your/anthropicFun"]
      // 文件系统服务器，允许 Claude 访问和操作本地文件系统
      // args 参数指定了服务器访问的根目录，默认为用户家目录下的 anthropicFun 文件夹
    },
    "codesnip": {
      "command": "npx",
      "args": ["@patruff/server-codesnip"]
      // 代码片段服务器，允许 Claude 编辑文件中的部分代码片段
    },
    "memory": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-memory"]
      // 内存服务器，提供简单的内存存储功能，用于上下文信息的快速存取
    },
    "lightrag": {
      "command": "npx",
      "args": ["@patruff/server-lightrag"],
      "env": {
        "LIGHTRAG_API_URL": "http://127.0.0.1:8020"
        // LightRAG 服务器的 API 地址，如果 LightRAG 服务器运行在非默认地址，需要修改此配置
      }
      // LightRAG 服务器，提供 RAG (Retrieval-Augmented Generation) 检索增强生成能力
    },
    "sqlite": {
      "command": "uvx",
      "args": ["mcp-server-sqlite", "--db-path", "~/test.db"]
      // SQLite 服务器，提供基于 SQLite 数据库的数据访问能力
      // --db-path 参数指定了 SQLite 数据库文件的路径
    },
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time"]
      // 时间服务器，提供访问当前时间的功能
    },
    "todoist": {
      "command": "npx",
      "args": ["@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_api_token"
        // Todoist API Token，用于访问用户的 Todoist 任务管理信息
      }
      // Todoist 服务器，集成 Todoist 任务管理功能
    },
    "gmail-drive": {
      "command": "npx",
      "args": ["@patruff/server-gmail-drive"]
      // Gmail/Drive 服务器，集成 Gmail 和 Google Drive 功能，需要预先完成 Google Cloud OAuth 认证
    },
    "brave-search": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your_brave_search_api_key"
        // Brave Search API Key，用于访问 Brave Search 搜索引擎
      }
      // Brave Search 服务器，提供互联网搜索能力
    },
    "github": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat_token"
        // GitHub Personal Access Token，用于访问用户的 GitHub 仓库信息
      }
      // GitHub 服务器，集成 GitHub 仓库访问功能
    },
    "terminator": {
      "command": "npx",
      "args": ["@patruff/server-terminator"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat_token"
        // GitHub Personal Access Token，同样用于某些操作的权限验证
      }
      // Terminator 服务器，可能提供文件删除等系统级操作（根据描述 "File deletion bot" 推测）
    },
    "flux": {
      "command": "npx",
      "args": ["@patruff/server-flux"],
      "env": {
        "REPLICATE_API_TOKEN": "your_replicate_api_token"
        // Replicate AI API Token，用于访问 Replicate 上的模型，可能用于图像生成等任务 (根据描述 "robot artist" 推测)
      }
      // Flux 服务器，可能集成 AI 图像生成或其他模型服务
    }
  }
}

注意: 以上 'claude_desktop_config.json' 示例中的 'command' 和 'args' 字段是 MCP 客户端 (如 Claude) 用来启动和连接 MCP 服务器的关键配置信息。用户无需直接修改这些配置，'mcp_setup.py' 脚本会自动处理。用户只需要确保 Claude 桌面应用正确加载了更新后的 'claude_desktop_config.json' 文件，即可在 Claude 中使用这些 MCP 服务器的功能。

基本使用方法

完成安装和配置后，在支持 MCP 协议的 LLM 客户端 (如 Claude) 中，您应该能够使用已配置的 MCP 服务器提供的功能。具体使用方式取决于各个 MCP 服务器的功能和 LLM 客户端的集成方式。例如：

文件系统服务器: 可能允许 LLM 读取和操作本地文件。
GitHub 服务器: 可能允许 LLM 访问和分析 GitHub 仓库。
Brave Search 服务器: 可能允许 LLM 进行互联网搜索并获取信息。
LightRAG 服务器: 可能为 LLM 提供基于本地知识库的检索增强生成能力。

请参考各个 MCP 服务器的文档和 LLM 客户端的使用说明，了解如何具体调用和使用这些功能。

关键词