基础脑
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, ...) |
录制新课程 |
本地开发```bash
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环境变量:```env
POSTGRES_PASSWORD=
APP_ENV=production
LOG_LEVEL=INFO
API服务构建 DATABASE_URL 启动时从 POSTGRES_HOST, POSTGRES_DB, POSTGRES_USER,以及 POSTGRES_PASSWORD,自动应用密码URL编码。如果在首次启动后更改了Postgres密码,则必须更新Postgres中的角色密码或重新创建Postgres卷。
内联Postgres服务使用唯一的主机名 infrabrain-db 以避免Coolify共享网络上的冲突。
部署的API容器在端口上侦听 80,而当地发展仍将其映射到 localhost:8000.
MCP连接测试```bash
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 200`
- `Content-Type: application/json`
- JSON-RPC初始化响应体
实时服务器使用FastMCP流式HTTP `json_response=True` 和
`stateless_http=True`,这避免了代理后面的流式POST响应问题。
## 连接到克劳德代码
增添 `~/.mcp.json`:```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 → 冷却
