AI导哈

原子化仓库操作服务

Titanium Repo Operator 是一个异步优先的MCP服务器，为自主编码代理提供原子化、可审计的仓库操作。

  • by Senpai-Sama7
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Senpai-Sama7/Titanium-MCP

使用说明

钛回购运营商

Titanium Repo Operator是一个异步优先的MCP服务器，为自主编码代理提供原子、可审计的回购操作。经过测试，CI强制，可重复运行。

快速入门

curl -LsSf https://astral.sh/uv/install.sh | sh
make test
make run

期望输出

EVAL RESULTS
smoke: pass (12.34ms)
tool_contract: pass (20.11ms)
atomic_write: pass (3.42ms)
checks_passed: 3/3
safe_commands: 5

评估

运行评估套件：

make eval
度量 命令 预期
评估通过率 make eval 3/3 (100%)
SAFE_COMMANDS计数 make eval 5

正确性证据

make eval 包括对工具契约合规性和原子写入的轻量级检查。

检查 信号 示例结果
工具合同合规性 所有预期工具均已注册；生成的模式 通过，<25ms
禁止路径拒绝 validate_path("../forbidden") 升高 通过，<5ms
原子写入保证 内容匹配最新，无临时文件 通过，<5ms

快速入门（本地）

推荐（紫外线）：

curl -LsSf https://astral.sh/uv/install.sh | sh
make run

可编辑安装（pip）：

pip install -e .
titanium-mcp

快速入门（docker）

docker compose up --build

验证（60秒验证）

make test
make eval

CI强制执行lint、类型检查、单元测试和覆盖率（最低65%）。

评估

运行评估套件：

make eval

期望输出

EVAL RESULTS
smoke: pass (12.34ms)
tool_contract: pass (20.11ms)
atomic_write: pass (3.42ms)
checks_passed: 3/3
safe_commands: 5
度量 命令 预期
评估通过率 make eval 3/3 (100%)
SAFE_COMMANDS计数 make eval 5

正确性证据

make eval 包括对工具契约合规性和原子写入的轻量级检查。

检查 信号 示例结果
工具合同合规性 所有预期工具均已注册；生成的模式 通过，<25ms
禁止路径拒绝 validate_path("../forbidden") 升高 通过，<5ms
原子写入保证 内容匹配最新，无临时文件 通过，<5ms

生产说明

  • 使用随附的 Dockerfile 以构建容器映像。
  • 默认情况下，在禁用网络的情况下运行容器，并在下装载工作区 /workspace.
  • 将机密与Vault/云KMS集成；不要将代币烘焙成图像。
  • 集 TITANIUM_AUDIT_KEY 适用于非开发环境；默认密钥被拒绝。

文件

  • titanium_repo_operator/ --包含服务器、工具、策略和实用程序的包
  • server.py --兼容性垫片 uv run server.py
  • Dockerfile --生产容器
  • k8s/deployment.yaml --k8s部署清单示例
  • .github/workflows/ci.yaml --CI工作流程
  • build-and-push.sh --用于CI的Docker构建脚本
  • SECURITY.md --安全强化指南和检查表
  • Makefile — make run, make test, make eval
  • evals/smoke_eval.py --对回购结构和SAFE_COMMANDS进行烟雾检查
  • evals/tool_contract_eval.py --工具注册表和模式合规性检查
  • evals/atomic_write_eval.py --原子写入不变量检查
  • evals/run_eval.py --联合评估跑者

相关 MCP