Sot MCP Server

SOT服务器

真相之源服务器-通过REST API和 主控程序 对于AI代理。使用Sinatra、Sequel和SQLite构建。

管理员定义的模式描述了具有类型化字段和可选状态机的表。记录是CRUD的，带有比较和交换前提条件以及完整的审计跟踪。

快速启动

Docker（推荐）

docker compose up -d
docker compose run --rm sot-server bundle exec rake db:seed   # creates admin user, prints token

本地

bundle install
rake server            # starts on port 39482
curl -X POST http://localhost:39482/install   # creates admin user, returns token

保存令牌，它将不再显示。将其用作所有后续请求的承载令牌。

API

所有端点（除 /install)要求 Authorization: Bearer .

以MCP身份连接

服务器在上公开了可流式HTTP MCP传输 /mcp （用户工具）和 /mcp/admin （管理工具）。需要承载令牌身份验证。

克劳德代码（CLI）

claude mcp add sot-user -t http http://localhost:39482/mcp \
  -H "Authorization: Bearer "

claude mcp add sot-admin -t http http://localhost:39482/mcp/admin \
  -H "Authorization: Bearer "

JSON配置(.mcp.json 或 claude mcp add-json)

{
  "mcpServers": {
    "sot-user": {
      "type": "http",
      "url": "http://localhost:39482/mcp",
      "headers": {
        "Authorization": "Bearer "
      }
    },
    "sot-admin": {
      "type": "http",
      "url": "http://localhost:39482/mcp/admin",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

码头工人

该应用程序在多阶段Docker构建中运行 ruby:3.3-slim.SQLite数据库存储在绑定挂载的主机目录上(./data/).

每次启动容器时，迁移都会自动运行。要手动运行它们，请执行以下操作：

docker compose run --rm sot-server bundle exec rake db:migrate

通过环境变量进行配置 docker-compose.yml:

发展

rake spec              # run tests
rake db:create_migration[name]   # generate migration