uol-mcp-http

用于 UOL Accounting REST API 的 HTTP MCP 服务器（适用于 Railway 和 Cursor 的 Streamable HTTP）。

读取操作会立即执行。POST / PATCH / PUT / DELETE 经由 uol_request 处理，并且需要 confirm=true。

环境变量

• UOL_API_BASE_URL — 租户 API 根地址，例如 https://YOUR-TENANT.ucetnictvi.uol.cz/api（带或不带 /v1）

• UOL_API_EMAIL — UOL 登录邮箱（Basic Auth 用户名）

• UOL_API_TOKEN — 来自 UOL Settings → /api_tokens 的令牌

• MCP_AUTH_TOKEN — MCP 客户端所需的 Bearer 令牌

• PORT — 监听端口（Railway 会设置此值）

演示（OpenAPI）：https://test.demo.uol.cz/api + 来自 https://api.uol.cz/ 的演示邮箱/令牌

Related MCP server: MCP Moloni ON

端点

• GET /health — 健康检查

• POST /mcp — MCP Streamable HTTP（需要认证）

Cursor

不要提交真实令牌。在本地 .cursor/mcp.json 中添加以下内容：

{
  "mcpServers": {
    "uol": {
      "url": "https://uol-mcp-production.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_AUTH_TOKEN"
      }
    }
  }
}

YOUR_MCP_AUTH_TOKEN 即本地 .deploy-secrets（已被 git 忽略）和 Railway 服务中的 MCP_AUTH_TOKEN。

此实例当前连接的是 UOL demo 租户（https://test.demo.uol.cz/api）。如需用于 Gramodesky 生产账务，请将 Railway 变量 UOL_API_BASE_URL / UOL_API_EMAIL / UOL_API_TOKEN 改为生产租户（与商店 UOL_API_* 的值相同）。

GramBot（后续）

当商店工作树干净时，使用 MCP_UOL_URL + MCP_UOL_TOKEN 接入 HTTP MCP（与 Daktela / Fio 相同的模式）。

速率限制

UOL 在超出限制时会返回 HTTP 429，持续 30 秒：30 次请求 / 10 秒（应收账款：10 次 / 10 秒）。