基础脑
Devon应用程序组合的基础设施知识注册表。作为MCP服务器公开。
MCP端点： https://infra-brain.devonwatkins.com/mcp 还接受： https://infra-brain.devonwatkins.com/mcp/ 健康： https://infra-brain.devonwatkins.com/api/health
它存储了什么
| 表 | 目录 |
|---|---|
versions | 产品组合中每个软件包的规范固定版本 |
rules | AI代理必须遵循硬约束（BLOCK）和警告（WARN/INFO） |
combos | 已验证的全栈依赖关系集 |
lessons | 生产发现和事故事后分析 |
MCP工具
| 工具 | 目的 |
|---|---|
get_version(package) | 获取软件包的规范版本 |
list_versions(ecosystem?) | 列出所有版本，按生态系统筛选 |
update_version(package, canonical, ...) | 更新现有软件包版本 |
add_version(package, canonical, ...) | 添加新包 |
get_rules(category?, severity?) | 获取规则——始终检查 severity="BLOCK" 首先 |
add_rule(severity, category, rule, reason) | 添加新规则 |
get_combo(name) | 获取经过验证的全栈依赖集 |
list_combos(ecosystem?, flavor?) | 列出所有组合 |
search_lessons(query, app?, tags?) | 全文搜索课程 |
add_lesson(title, content, ...) | 录制新课程 |
本地开发
cp .env.example .env
# Edit .env — set POSTGRES_PASSWORD
docker compose -f docker-compose.yml -f docker-compose.local.yml up --build
curl http://localhost:8000/api/health
# → {"status": "ok", "app": "infra-brain", "db": "connected"}冷却部署
在Coolify中部署此仓库作为 Private Repository (GitHub App) 应用程序使用 Docker Compose 使用组合位置构建包 docker-compose.yml.
所需的Coolify环境变量：
POSTGRES_PASSWORD=
APP_ENV=production
LOG_LEVEL=INFOAPI服务构建 DATABASE_URL 启动时从 POSTGRES_HOST, POSTGRES_DB, POSTGRES_USER，以及 POSTGRES_PASSWORD，自动应用密码URL编码。如果在首次启动后更改了Postgres密码，则必须更新Postgres中的角色密码或重新创建Postgres卷。 内联Postgres服务使用唯一的主机名 infrabrain-db 以避免Coolify共享网络上的冲突。 部署的API容器在端口上侦听 80，而当地发展仍将其映射到 localhost:8000.
MCP连接测试
# Local
npx @modelcontextprotocol/inspector http://localhost:8000/mcp
# Remote initialize probe
curl -i --max-time 20 \
https://infra-brain.devonwatkins.com/mcp/ \
-H 'Accept: application/json, text/event-stream' \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}},"id":1}'预期远程结果：
HTTP 200Content-Type: application/json- JSON-RPC初始化响应体
实时服务器使用FastMCP流式HTTP json_response=True 和 stateless_http=True，这避免了代理后面的流式POST响应问题。
连接到克劳德代码
增添 ~/.mcp.json:
{
"mcpServers": {
"infra-brain": {
"url": "https://infra-brain.devonwatkins.com/mcp"
}
}
}如果您已经配置，则不需要更改连接器URL https://infra-brain.devonwatkins.com/mcp。服务器现在接受这两者 /mcp 和 /mcp/.
堆栈
- 快速API 0.115.6 + FastMCP 2.3.4
- PostgreSQL 16 + SQLAlchemy 2.0.36（异步）+ 蒸馏器 1.13.3
- Docker Compose → 冷却