项目简介
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)。
-
克隆仓库
git clone https://github.com/lamemind/coder-toolbox-mcp-server.git cd coder-toolbox-mcp-server -
安装依赖
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>' 替换为你的实际路径。 这两个路径是服务器运行所必需的,用于指定代码仓库的位置和日志文件的位置。
基本使用方法
- 启动 MCP 服务器: 配置好 MCP 客户端后,客户端会根据你提供的配置启动 Coder Toolbox MCP Server。
- 客户端调用工具: 在你的 LLM 应用中,你可以指示 LLM 客户端调用服务器提供的工具。例如,你可以指示 LLM 使用 'locate_java_class' 工具来查找特定的 Java 类,或者使用 'create_java_class' 工具来创建一个新的 Java 类。
- 利用工具功能: LLM 客户端会将你的请求(例如查找类、创建类等)通过 MCP 协议发送给 Coder Toolbox MCP Server。服务器执行相应的操作后,会将结果返回给客户端,LLM 应用就可以利用这些结果进行后续处理,例如代码分析、代码修改等。
示例场景:
假设你希望 LLM 客户端帮助你在 Java 项目中创建一个新的 Service 类。你可以指示 LLM 客户端调用 'create_java_class' 工具,并提供类名、包路径等参数。Coder Toolbox MCP Server 接收到请求后,会在你的项目源代码目录中创建相应的 Java 类文件,并将创建结果返回给 LLM 客户端。
信息
分类
开发者工具