AcemcpCAUTION

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

简体中文 | English

代码库索引和语义搜索的 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", ...]

配置选项:

• BATCH_SIZE: 每批上传的文件数量(默认:10)
• MAX_LINES_PER_BLOB: 大文件分割前的最大行数(默认:800)
• BASE_URL: API 端点 URL
• TOKEN: 认证令牌
• TEXT_EXTENSIONS: 要索引的文件扩展名列表
• EXCLUDE_PATTERNS: 要排除的模式列表(支持通配符如 *.pyc)

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

• 命令行参数(最高优先级):--base-url、--token
• Web 管理界面(更新用户配置文件)
• 环境变量(使用 ACEMCP_ 前缀)

MCP 配置

将以下内容添加到您的 MCP 客户端配置中(例如 Claude Desktop):

基础配置

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

可用的命令行参数:

• --base-url: 覆盖 BASE_URL 配置
• --token: 覆盖 TOKEN 配置
• --web-port: 在指定端口启用 Web 管理界面(例如 8080)

启用 Web 管理界面的配置

要启用 Web 管理界面,添加 --web-port 参数:

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

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

Web 管理功能:

• 配置管理:查看和编辑服务器配置(BASEURL、TOKEN、BATCHSIZE、MAXLINESPERBLOB、TEXTEXTENSIONS)
• 实时日志:通过 WebSocket 连接实时监控服务器日志,具有智能重连功能
• 指数退避重连策略(1秒 → 1.5秒 → 2.25秒 ... 最大 30秒