AI导哈

构建历史查询服务

一个允许AI助手查询IncrediBuild构建历史记录的Model Context Protocol（MCP）服务器。

  • by Incredibuild-RND
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Incredibuild-RND/incredibuild-mcp-server

使用说明

IncrediBuild MCP服务器

A. 模型上下文协议 （MCP）服务器，允许AI助手查询您的IncrediBuild构建历史。

特性

  • ✅ stdio 无缝AI客户端集成的传输
  • ✅ 两种查询工具：按绝对时间戳或相对时间
  • ✅ Docker支持容器化部署
  • ✅ 通过环境变量配置数据库位置

快速开始

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 或克劳德桌面设置）：

{
  "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\):

{
  "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

发展

# 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

许可证

看 许可证

相关 MCP