Ace -Node

Acemcp Node 是一个高性能的 MCP 服务端实现，专为 AI 助手（如 Claude、GPT 等）提供代码库索引与语义搜索能力。它通过标准 MCP 协议对接客户端，支持实时日志查看、配置管理、以及工具调试。服务器提供增量索引、批量上传、以及对多种编码的自动处理，使得 AI 助手能够快速检索带行号的代码片段并进行语义查询。可通过 Web 管理界面查看状态、编辑配置并使用 search_context 等内置工具进行语义搜索和上下文检索。通过 npx、npm 以及本地运行等不同方式启动后，可以在本地或服务器上以 stdio 模式与 MCP 客户端协同工作，也可通过 Web 界面进行管理。

Prerequisites:

• Node.js >= 18.0.0
• npm >= 8.0.0 (或 yarn、pnpm)
• 具备 Git（用于从源码安装的场景）

安装步骤：

1. 全局安装（推荐用于 MCP 客户端接入）

npm install -g acemcp-node

验证安装与版本：

node -e "console.log(require('acemcp-node/package.json').version)"

2. 本地安装（用于项目集成）

# 创建并进入项目目录
mkdir my-mcp-project && cd my-mcp-project

# 初始化 package.json
npm init -y

# 安装 acemcp-node
npm install acemcp-node

# 运行
npx acemcp-node

3. 从源码安装（开发模式）

git clone https://github.com/yeuxuan/Ace-Mcp-Node.git
cd Ace-Mcp-Node
npm install
npm run build

# 开发模式（自动重载）
npm run dev

首次运行时，程序会在默认目录创建配置文件，例如 ~/.acemcp/settings.toml。你也可以通过传递配置覆盖默认设置，详细见配置章节。

配置与运行提示：

• mcpServers 配置示例通常采用 npx + acemcp-node 的组合，适用于快速接入 MCP 客户端。示例： { "mcpServers": { "acemcp": { "command": "npx", "args": ["acemcp-node"] } } }
• 通过 Web 界面启动时，可以在启动参数中添加 --web-port 来指定端口，例如 npm start -- --web-port 8080。
• 运行时可通过 CLI 参数覆盖 API 配置、批量大小等设置，示例：npm start -- --base-url https://api.example.com --token YOUR_TOKEN --web-port 8080
• 该实现支持增量索引、跨平台、多编码检测等特性，确保在不同开发环境下也能稳定工作。
• 环境变量占位符：env 字段支持添加如 TOKEN、BASE_URL 等敏感信息，请在实际部署时填充。