Acemcp is an MCP server that integrates ACE (Augment Context Engine) to provide semantic search capabilities across code repositories. It indexes local project files and enables natural language queries to find relevant code contexts through an external API. Key features of Acemcp: - Automatic incremental indexing that scans only new or modified files before each search, ensuring results stay current without manual intervention - Semantic code search that matches query intent to code meaning rather than simple keyword matching - Multi-encoding support for files using UTF-8, GBK, GB2312, Latin-1, and other formats with automatic detection - .gitignore integration that respects excluded patterns during the indexing process - Web management interface for configuration editing, real-time log monitoring via WebSocket, and built-in tool debugging - Configurable file type filtering with customizable text extensions and exclusion patterns

[](https://mseep.ai/app/qy527145-acemcp)

简体中文 | English

Acemcp

代码库索引和语义搜索的 MCP 服务器。

安装

作为工具安装（推荐）

# 安装到系统
uv tool install acemcp
或临时运行（无需安装）
uvx acemcp

开发安装

# 克隆仓库
git clone https://github.com/qy527145/acemcp.git
cd acemcp
安装依赖
uv sync
运行
uv run acemcp

配置

配置文件会在首次运行时自动创建在 ~/.acemcp/settings.toml，包含默认值。

编辑 ~/.acemcp/settings.toml 进行配置：

BATCH_SIZE = 10
MAX_LINES_PER_BLOB = 800
BASE_URL = "https://your-api-endpoint.com"
TOKEN = "your-bearer-token-here"
TEXT_EXTENSIONS = [".py", ".js", ".ts", ...]
EXCLUDE_PATTERNS = [".venv", "node_modules", ".git", "__pycache__", "*.pyc", ...]

配置选项：

您还可以通过以下方式配置：

MCP 配置

将以下内容添加到您的 MCP 客户端配置中（例如 Claude Desktop）：

基础配置

{
  "mcpServers": {
    "acemcp": {
      "command": "uvx",
      "args": [
        "acemcp"
      ]
    }
  }
}

可用的命令行参数：

启用 Web 管理界面的配置

要启用 Web 管理界面，添加 --web-port 参数：

{
  "mcpServers": {
    "acemcp": {
      "command": "uvx",
      "args": [
        "acemcp",
        "--web-port",
        "8888"
      ]
    }
  }
}

然后访问管理界面：http://localhost:8888

Web 管理功能：

工具

search_context

基于查询搜索相关的代码上下文。此工具在搜索前自动执行增量索引，确保结果始终是最新的。它在您的代码库中执行语义搜索，并返回格式化的文本片段，显示相关代码的位置。

核心特性：

参数：

返回内容：

查询示例：

1. 查找配置代码：

   {
     "project_root_path": "C:/Users/username/projects/myproject",
     "query": "日志配置 设置 初始化 logger"
   }
   

2. 查找认证逻辑：

   {
     "project_root_path": "C:/Users/username/projects/myproject",
     "query": "用户认证 登录 密码验证"
   }
   

3. 查找数据库代码：

   {
     "project_root_path": "C:/Users/username/projects/myproject",
     "query": "数据库连接池 初始化"
   }
   

4. 查找错误处理：

   {
     "project_root_path": "C:/Users/username/projects/myproject",
     "query": "错误处理 异常 try catch"
   }
   

5. 查找 API 端点：

   {
     "project_root_path": "C:/Users/username/projects/myproject",
     "query": "API 端点 路由 HTTP 处理器"
   }
   

获得更好结果的技巧：

索引特性：

搜索特性：

默认排除模式：

.venv, venv, .env, env, node_modules, .git, .svn, .hg, __pycache__,
.pytest_cache, .mypy_cache, .tox, .eggs, *.egg-info, dist, build,
.idea, .vscode, .DS_Store, *.pyc, *.pyo, *.pyd, .Python,
pip-log.txt, pip-delete-this-directory.txt, .coverage, htmlcov,
.gradle, target, bin, obj

注意： 如果项目根目录存在 .gitignore 文件，其模式将自动加载并与配置的排除模式结合使用。.gitignore 模式遵循 Git 的标准 wildmatch 语法。

高级特性

多编码文件支持

Acemcp 自动检测和处理不同字符编码的文件，适用于国际化项目：