项目简介

Coder Toolbox MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务,专注于为 Claude 等 LLM 客户端提供代码相关的上下文信息和功能。它通过标准化的 MCP 协议,允许 LLM 客户端调用工具来分析、操作 Java 代码库,并检索测试执行日志,从而实现更智能的代码交互和工作流程自动化。

主要功能点

  • 测试执行日志检索: 允许 LLM 客户端获取和分析测试执行日志,帮助理解代码测试结果和运行状况。
  • Java 类操作: 提供了一系列用于操作 Java 类的工具,包括:
    • 查找 Java 类: 根据类名和包路径在项目源代码中定位 Java 类文件。
    • 创建 Java 类: 根据指定的类名、源类型和包路径创建新的 Java 类文件。
    • 内容管理: 在现有的 Java 类文件中添加、替换或删除内容,例如添加新的方法、修改类体等。

这些功能旨在帮助 LLM 更好地理解和操作 Java 代码,例如在代码生成、代码修复、代码审查等场景中,LLM 可以利用这些工具来获取代码上下文、修改代码结构、并验证代码变更。

安装步骤

由于这是一个 Node.js 项目,你需要先安装 Node.js 和 npm (或 yarn)。

  1. 克隆仓库

    git clone https://github.com/lamemind/coder-toolbox-mcp-server.git
    cd coder-toolbox-mcp-server
  2. 安装依赖

    npm install

服务器配置

要将 Coder Toolbox MCP Server 与 MCP 客户端连接,你需要配置客户端以启动该服务器。以下是一个 JSON 格式的配置示例,你需要将其添加到你的 MCP 客户端配置中。

{
  "serverName": "java-toolbox",
  "command": "node",
  "args": [
    "src/index.ts",
    "<project_path>",  // 请替换为你的 Java 项目的根目录的绝对路径,例如 "/path/to/your/java/project"
    "<log_directory>"   // 请替换为你的测试日志文件存放目录的绝对路径,例如 "/path/to/your/logs"
  ],
  "transport": "stdio"
}

参数说明:

  • 'serverName': 服务器的名称,可以自定义,用于在客户端识别和管理服务器连接。
  • 'command': 启动服务器的命令,这里是 'node',因为服务器是 Node.js 应用。
  • 'args': 传递给 'node' 命令的参数数组:
    • '"src/index.ts"': 服务器入口文件路径。
    • '"<project_path>"': [重要] 你需要将其替换为你的 Java 项目根目录的绝对路径。服务器将在这个目录下搜索和操作 Java 代码文件。
    • '"<log_directory>"': [重要] 你需要将其替换为你的 测试日志文件存放目录的绝对路径。服务器将从这个目录读取测试执行日志文件。
  • 'transport': 通信协议,这里使用 'stdio',表示通过标准输入/输出流进行通信。

请务必将 '<project_path>' 和 '<log_directory>' 替换为你的实际路径。 这两个路径是服务器运行所必需的,用于指定代码仓库的位置和日志文件的位置。

基本使用方法

  1. 启动 MCP 服务器: 配置好 MCP 客户端后,客户端会根据你提供的配置启动 Coder Toolbox MCP Server。
  2. 客户端调用工具: 在你的 LLM 应用中,你可以指示 LLM 客户端调用服务器提供的工具。例如,你可以指示 LLM 使用 'locate_java_class' 工具来查找特定的 Java 类,或者使用 'create_java_class' 工具来创建一个新的 Java 类。
  3. 利用工具功能: LLM 客户端会将你的请求(例如查找类、创建类等)通过 MCP 协议发送给 Coder Toolbox MCP Server。服务器执行相应的操作后,会将结果返回给客户端,LLM 应用就可以利用这些结果进行后续处理,例如代码分析、代码修改等。

示例场景:

假设你希望 LLM 客户端帮助你在 Java 项目中创建一个新的 Service 类。你可以指示 LLM 客户端调用 'create_java_class' 工具,并提供类名、包路径等参数。Coder Toolbox MCP Server 接收到请求后,会在你的项目源代码目录中创建相应的 Java 类文件,并将创建结果返回给 LLM 客户端。

信息

分类

开发者工具