hoba
API для розробників та MCP

Машинні інтерфейси та SDK

Доступ до графа знань HOBA через статичні REST-ендпоінти, OpenAPI 3.1, Model Context Protocol (MCP) та CLI.

Статичний REST API

/openapi.json →

Детерміновані статичні JSON-ендпоінти лише для читання, що віддаються безпосередньо з CDN без бази даних.

GET /api/v1/artifacts Переглянути JSON
GET /api/v1/barriers Переглянути JSON
GET /api/v1/mechanisms Переглянути JSON
GET /api/v1/patterns Переглянути JSON
GET /api/v1/loops Переглянути JSON
GET /api/v1/interventions Переглянути JSON
GET /api/v1/evidence Переглянути JSON
GET /api/v1/graph Переглянути JSON

Сервер Model Context Protocol (MCP)

stdio · локально

Підключіть AI-асистентів і автономних агентів безпосередньо до графа знань HOBA.

// claude_desktop_config.json / .mcp.json — запуск із локального клону
// (git clone … && pnpm install && pnpm build:packages)
{
  "mcpServers": {
    "hoba": {
      "command": "node",
      "args": ["/path/to/hoba.work/packages/mcp/dist/index.js", "--dir", "/path/to/hoba.work"]
    }
  }
}
Доступні інструменти:

get_registry_info, search_registry, get_node, explain_observation, find_compatible_mechanisms, get_diagnostic_probes, find_patterns, get_interventions, traverse_graph, get_methodology.

Пакети ще не опубліковані в npm; форма npx @hoba/mcp запрацює після публікації.

Інтерфейс командного рядка (CLI)

pnpm build:packages && node packages/cli/dist/cli.js --help

hoba search "reposted" — Знайти відповідні сутності

hoba explain A-004 --stage technical — Запустити діагностичний протокол HOBA

hoba show M-001 — Переглянути специфікацію механізму

hoba validate --strict — Перевірити контент, DAG, оголошення циклів і паритет перекладу

Додайте --json до будь-якої команди для машиночитного виводу.