使用说明
项目简介
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' 服务器为例,安装步骤通常如下(其他服务器类似,请务必查看对应服务器目录下的说明文档):
- 环境准备: 确保已安装 Node.js 和 npm。
- 进入目录: 'cd mcp-servers/brave-search'
- 安装依赖: 'npm install'
- 构建项目: 'npm run build'
- 配置环境变量: 设置 'BRAVE_API_KEY' 环境变量,用于访问 Brave Search API。(请参考 Brave Search API 的官方文档获取 API 密钥)
- 启动服务器: '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 官方文档 }
基本使用方法
- 启动 MCP 服务器: 根据您选择的服务器,按照上述安装步骤启动服务器。确保服务器成功运行并监听来自 MCP 客户端的请求。
- 配置 MCP 客户端: 在您的 MCP 客户端(例如 Claude)中,添加并配置上述生成的服务器连接信息。确保服务器名称 (serverName)、启动命令 (command) 和参数 (args) 配置正确。
- 使用 MCP 功能: 在 MCP 客户端中,您现在可以使用该服务器提供的功能了。例如,配置 Brave Search 服务器后,您可以使用 'brave_web_search' 工具进行网页搜索。
注意事项
- 环境变量: 部分服务器需要配置特定的环境变量,例如 API 密钥、Token 等。请务必仔细阅读每个服务器的说明文档,配置必要的环境变量。
- 路径配置: 配置文件中的路径需要根据您的实际文件路径进行调整。
- 安全性: 文件系统服务器和 Docker 服务器等涉及到本地资源操作的服务器,请务必谨慎配置,确保安全性。
信息
分类
开发者工具