使用说明内容（Markdown格式）

项目简介

Ace Tool 是一个基于 MCP 的服务器，专注于对代码仓库进行索引与语义检索，并向大语言模型（LLM）客户端暴露一个可被调用的工具接口（search_context），以便在对代码进行自然语言查询时提供相关上下文信息。

主要功能点

• 暴露 search_context 工具，供 LLM 调用以检索代码上下文
• 支持增量索引：仅上传新文件块，减少重复工作
• 处理文本内容的多编码读取与错误处理
• 日志系统：通过 MCP 推送日志到客户端并可选写入本地文件
• 兼容 MCP JSON-RPC 请求：实现 ListTools 和 CallTool 两种请求，方便客户端发现并执行工具
• 基于标准输入输出（stdio）传输，易于在多种运行环境中部署

安装步骤

• 全局安装
  • npm install -g ace-tool
• 直接使用
  • npx ace-tool --base-url <URL> --token <TOKEN>

服务器配置

配置示例（供 MCP 客户端配置注册服务器使用，不需要客户端额外开发）: { "name": "ace-tool", "command": "npx", "args": [ "ace-tool", "--base-url", "<YOUR_BASE_URL>", "--token", "<YOUR_TOKEN>" ] } 注释：该配置使 MCP 客户端能够通过命令行启动 ace-tool 服务，并以 base URL 与令牌进行认证。

基本使用方法

• 启动服务器：按照上述配置，在 MCP 客户端中注册后通过命令启动，ace-tool 将通过 stdio 与客户端通信
• 调用工具：通过 MCP 的 ListTools 请求获取可用工具列表（其中包含 search_context），再通过 CallTool 请求执行该工具
• 查看结果：search_context 的返回将以文本形式提供，LLM 可将其作为上下文信息进行进一步推理