iflow-mcp-qy527145-acemcp

[](https://mseep.ai/app/qy527145-acemcp) 简体中文 | [English](./README_EN.md) # Acemcp 代码库索引和语义搜索的 MCP 服务器。 <a href="https://glama.ai/mcp/servers/@qy527145/acemcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@qy527145/acemcp/badge" alt="Acemcp MCP server" /> </a> ## 安装 ### 作为工具安装（推荐） ```bash # 安装到系统 uv tool install acemcp # 或临时运行（无需安装） uvx acemcp ``` ### 开发安装 ```bash # 克隆仓库 git clone https://github.com/qy527145/acemcp.git cd acemcp # 安装依赖 uv sync # 运行 uv run acemcp ``` ## 配置 配置文件会在首次运行时自动创建在 `~/.acemcp/settings.toml`，包含默认值。 编辑 `~/.acemcp/settings.toml` 进行配置： ```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）： ### 基础配置 ```json { "mcpServers": { "acemcp": { "command": "uvx", "args": [ "acemcp" ] } } } ``` **可用的命令行参数：** - `--base-url`: 覆盖 BASE_URL 配置 - `--token`: 覆盖 TOKEN 配置 - `--web-port`: 在指定端口启用 Web 管理界面（例如 8080） ### 启用 Web 管理界面的配置 要启用 Web 管理界面，添加 `--web-port` 参数： ```json { "mcpServers": { "acemcp": { "command": "uvx", "args": [ "acemcp", "--web-port", "8888" ] } } } ``` 然后访问管理界面：`http://localhost:8888` **Web 管理功能：** - **配置管理**：查看和编辑服务器配置（BASE_URL、TOKEN、BATCH_SIZE、MAX_LINES_PER_BLOB、TEXT_EXTENSIONS） - **实时日志**：通过 WebSocket 连接实时监控服务器日志，具有智能重连功能 - 指数退避重连策略（1秒 → 1.5秒 → 2.25秒 ... 最大 30秒…