spine (Roman Savh)

脊柱

AI代理的系统知识注册表。

Spine存储有关微服务架构的结构化知识-服务、数据库架构、队列契约、gRPC/HTTP API-并通过REST API和MCP公开这些知识。AI代理在做出决策之前会查询Spine以了解系统。

特性

• REST API 对服务、表、队列、原型合约、HTTP合约进行完整的CRUD操作
• MCP服务器 （SSE/HTTP），配备12个AI代理消费工具
• 语义搜索 通过嵌入（nomic-embed-ext-v1.5）
• 依赖图 源自服务关系
• 上下文端点 --在一个电话中获取有关服务的所有信息
• Swagger 用户界面 在 /swagger-ui/
• SQLite 存储

快速开始

Docker Compose

docker compose up

这将启动两个容器：

• spine （锈蚀）-端口3000上的API+MCP
• spine-embed （Python）——嵌入服务

嵌入模型在首次启动时下载（约500MB），并缓存在Docker卷中。

来自源头

# Start the embedding service
cd embed-service
pip install -r requirements.txt
uvicorn main:app --port 8000 &

# Start Spine
cargo run

配置

API

端点

API完整文档，网址： /swagger-ui/.

主控程序

MCP端点位于 /mcp （流式HTTP/SSE传输）。

阅读工具： list_services, get_service, list_tables, get_table, list_queues, get_queue, get_proto, get_http_contract, get_context, get_dependencies, search.

写入工具： register_service, update_service, delete_service, register_table, update_table, delete_table, register_queue, update_queue, delete_queue, register_proto, update_proto, delete_proto, register_http_contract, update_http_contract, delete_http_contract.

看 MCP.md 完整规格。

从任何MCP客户端连接：

{
  "mcpServers": {
    "spine": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

示例

# Create a service
curl -X POST http://localhost:3000/services \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "users-grpc",
    "description": "User management service",
    "grpc_servers": ["UsersGrpcService"],
    "queue_publishers": ["user-registered"],
    "tables": ["users"]
  }'

# Create a table
curl -X POST http://localhost:3000/tables \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "users",
    "database": "users-db",
    "owner": "users-grpc",
    "description": "User accounts",
    "ddl": "CREATE TABLE users (id UUID PRIMARY KEY, email TEXT NOT NULL);"
  }'

# Get full context
curl http://localhost:3000/context/users-grpc

# Search
curl "http://localhost:3000/search?q=user+registration"

# Dependency graph
curl http://localhost:3000/graph/dependencies/users-grpc

Docker镜像

每次发布时发布到GitHub容器注册表：

ghcr.io/romansavh/spine:latest
ghcr.io/romansavh/spine-embed:latest