使用说明

项目简介

claude-code-mcp 项目是一个 MCP 服务器集合,旨在为 Claude 等大型语言模型 (LLM) 提供丰富的上下文信息和外部功能。通过部署和配置这些 MCP 服务器,您可以显著增强 LLM 的能力,使其能够执行更复杂的任务,例如:

  • 信息检索: 利用 Brave Search 进行网页搜索,获取最新的网络信息。
  • 代码管理: 连接 GitHub 仓库,实现代码的浏览、编辑和版本控制。
  • 文件操作: 访问和操作本地文件系统,实现文件的读取、写入和编辑。
  • 环境管理: 通过 Docker 管理容器,创建和管理开发环境。
  • 数据处理: 连接和操作 SQLite 数据库,进行数据查询和分析。
  • 协同通信: 集成 Slack,实现消息发送和接收。
  • 知识管理: 构建和维护研究论文库,方便文献检索和管理。
  • 代码执行: 使用 E2B 沙箱安全地执行代码。

主要功能点

该项目包含多个独立的 MCP 服务器实现,每个服务器专注于提供特定的功能:

  • 多种功能集成: 涵盖了信息检索、代码管理、文件系统操作、数据库访问、通信工具和代码执行等多种实用功能。
  • 模块化设计: 每个 MCP 服务器都是独立的模块,易于部署、配置和维护。
  • 易于扩展: 项目结构清晰,方便开发者根据自身需求扩展和定制新的 MCP 服务器。
  • 参考实现: 部分服务器基于官方参考实现,并进行了扩展和改进。

安装步骤

由于该仓库本身是 MCP 服务器的集合,您无需安装该仓库本身。您需要根据您希望使用的具体 MCP 服务器,例如 'brave-search', 'github', 'docker' 等,进入相应的 'mcp-servers' 子目录,并按照其中 README 或相关文档的说明进行构建和部署。

以 'brave-search' 服务器为例,安装步骤通常如下(其他服务器类似,请务必查看对应服务器目录下的说明文档):

  1. 环境准备: 确保已安装 Node.js 和 npm。
  2. 进入目录: 'cd mcp-servers/brave-search'
  3. 安装依赖: 'npm install'
  4. 构建项目: 'npm run build'
  5. 配置环境变量: 设置 'BRAVE_API_KEY' 环境变量,用于访问 Brave Search API。(请参考 Brave Search API 的官方文档获取 API 密钥)
  6. 启动服务器: 'node dist/index.js'

服务器配置

MCP 客户端(如 Claude)需要配置 MCP 服务器的连接信息才能使用其功能。以下是针对不同服务器的配置示例 (JSON 格式),请根据您实际使用的服务器进行选择和配置。

Brave Search 服务器配置示例:

{
  "serverName": "brave-search",
  "command": "node",
  "args": ["/path/to/claude-code-mcp/mcp-servers/brave-search/dist/index.js"]
  // 请将 "/path/to/claude-code-mcp" 替换为您的 claude-code-mcp 仓库的实际路径
}

GitHub 服务器配置示例:

{
  "serverName": "github",
  "command": "node",
  "args": ["/path/to/claude-code-mcp/mcp-servers/github/index.js"]
  // 请将 "/path/to/claude-code-mcp" 替换为您的 claude-code-mcp 仓库的实际路径
  // GitHub 服务器需要 GITHUB_PERSONAL_ACCESS_TOKEN 环境变量,请确保已配置
}

Filesystem 服务器配置示例:

{
  "serverName": "filesystem",
  "command": "node",
  "args": ["/path/to/claude-code-mcp/mcp-servers/filesystem/index.js", "/allowed/directory/path"]
  // 请将 "/path/to/claude-code-mcp" 替换为您的 claude-code-mcp 仓库的实际路径
  // 请将 "/allowed/directory/path" 替换为您希望允许 MCP 服务器访问的目录路径,可以配置多个路径
}

Docker 服务器配置示例:

{
  "serverName": "docker",
  "command": "node",
  "args": ["/path/to/claude-code-mcp/mcp-servers/docker/dist/index.js"]
  // 请将 "/path/to/claude-code-mcp" 替换为您的 claude-code-mcp 仓库的实际路径
  // Docker 服务器可能需要配置 MCP_SERVERS_PATH 环境变量,指向模板文件夹
}

Memory 服务器配置示例:

{
  "serverName": "memory",
  "command": "node",
  "args": ["/path/to/claude-code-mcp/mcp-servers/memory/index.js"]
  // 请将 "/path/to/claude-code-mcp" 替换为您的 claude-code-mcp 仓库的实际路径
  // Memory 服务器可以通过 MEMORY_FILE_PATH 环境变量配置数据存储路径
}

Linear 服务器配置示例:

{
  "serverName": "linear",
  "command": "node",
  "args": ["/path/to/claude-code-mcp/mcp-servers/linear/dist/index.js"]
  // 请将 "/path/to/claude-code-mcp" 替换为您的 claude-code-mcp 仓库的实际路径
  // Linear 服务器需要 LINEAR_API_KEY 环境变量,请确保已配置
}

SQLite 服务器配置示例:

{
  "serverName": "sqlite",
  "command": "python",
  "args": ["/path/to/claude-code-mcp/mcp-servers/sqlite/src/mcp_server_sqlite/__init__.py", "--db-path", "./sqlite_mcp_server.db"]
  // 请将 "/path/to/claude-code-mcp" 替换为您的 claude-code-mcp 仓库的实际路径
  // 可以通过 --db-path 参数配置 SQLite 数据库文件路径
}

Research Papers 服务器配置示例:

{
  "serverName": "research-papers",
  "command": "node",
  "args": ["/path/to/claude-code-mcp/mcp-servers/research-papers/dist/index.js"]
  // 请将 "/path/to/claude-code-mcp" 替换为您的 claude-code-mcp 仓库的实际路径
}

Slack 服务器配置示例:

{
  "serverName": "slack",
  "command": "node",
  "args": ["/path/to/claude-code-mcp/mcp-servers/slack/index.js"]
  // 请将 "/path/to/claude-code-mcp" 替换为您的 claude-code-mcp 仓库的实际路径
  // Slack 服务器需要 SLACK_BOT_TOKEN 和 SLACK_TEAM_ID 环境变量,请确保已配置
}

E2B (Code Execution) 服务器配置示例:

{
  "serverName": "e2b",
  "command": "node",
  "args": ["/path/to/claude-code-mcp/mcp-servers/e2b/dist/index.js"]
  // 请将 "/path/to/claude-code-mcp" 替换为您的 claude-code-mcp 仓库的实际路径
  // E2B 服务器可能需要 E2B_API_KEY 环境变量,请参考 E2B 官方文档
}

基本使用方法

  1. 启动 MCP 服务器: 根据您选择的服务器,按照上述安装步骤启动服务器。确保服务器成功运行并监听来自 MCP 客户端的请求。
  2. 配置 MCP 客户端: 在您的 MCP 客户端(例如 Claude)中,添加并配置上述生成的服务器连接信息。确保服务器名称 (serverName)、启动命令 (command) 和参数 (args) 配置正确。
  3. 使用 MCP 功能: 在 MCP 客户端中,您现在可以使用该服务器提供的功能了。例如,配置 Brave Search 服务器后,您可以使用 'brave_web_search' 工具进行网页搜索。

注意事项

  • 环境变量: 部分服务器需要配置特定的环境变量,例如 API 密钥、Token 等。请务必仔细阅读每个服务器的说明文档,配置必要的环境变量。
  • 路径配置: 配置文件中的路径需要根据您的实际文件路径进行调整。
  • 安全性: 文件系统服务器和 Docker 服务器等涉及到本地资源操作的服务器,请务必谨慎配置,确保安全性。

信息

分类

开发者工具