IncrediBuild MCP服务器
A. 模型上下文协议 (MCP)服务器,允许AI助手查询您的IncrediBuild构建历史。
特性
- ✅
stdio无缝AI客户端集成的传输 - ✅ 两种查询工具:按绝对时间戳或相对时间
- ✅ Docker支持容器化部署
- ✅ 通过环境变量配置数据库位置
快速开始```bash
docker run -i --rm \
-v /path/to/your/db/folder:/data \
ghcr.io/incredibuild-rnd/incredibuild-mcp-server:v0.1.0
______________________________________________________________________
## 与AI客户端集成
### 光标/克劳德桌面
添加到MCP配置(`~/.cursor/mcp.json` 或克劳德桌面设置):```json
{
"mcpServers": {
"incredibuild": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-v", "/path/to/your/db/folder:/data",
"ghcr.io/incredibuild-rnd/incredibuild-mcp-server:v0.1.0"
]
}
}
}
替换 /path/to/your/db/folder 目录中包含您的 BuildHistoryDB.db.
Windows示例 (路径通常为 C:\ProgramData\Incredibuild\Manager\):```json
{
"mcpServers": {
"incredibuild": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-v", "C:/ProgramData/Incredibuild/Manager:/data",
"ghcr.io/incredibuild-rnd/incredibuild-mcp-server:v0.1.0"
]
}
}
}
______________________________________________________________________
## MCP工具
### `read_builds_in_time_range`
在两个绝对时间戳之间开始的查询构建。
|参数|类型|说明|
|-----------|------|-------------|
| `start_timestamp` |int |最早构建开始时间(纪元毫秒)|
| `end_timestamp` |int |最新构建开始时间(纪元毫秒)|
### `read_recent_builds`
查询相对于当前时间构建。
|参数|类型|说明|
|-----------|------|-------------|
| `start_time_ago` |int |最早构建(毫秒之前)|
| `end_time_ago` |int |最新版本(在此之前毫秒)|
**退货**:列表 `BuildMetadata` 对象具有:
- `BuildCaption`, `Status`, `BuildTime`, `StartTime`, `EndTime`
- `HasWarnings`, `ErrorsNumber`, `WarningsNumber`
- `SysErrorsNumber`, `SysWarningsNumber`, `EnvVars`
______________________________________________________________________
## 发展```bash
# Clone
git clone https://github.com/Incredibuild-RND/incredibuild-mcp-server.git
cd incredibuild-mcp-server
# Install
uv sync
# Test
uv run pytest -v
# Run locally
IB_DB_DIR=./testdata uv run python main.py
许可证
看 许可证
