Позволяет ИИ-агентам находить и выполнять API-операции с помощью эффективного по токенам рабочего процесса поиска и выполнения через OpenAPI, Google Discovery, GraphQL и gRPC.
Также известен как danielsmithdevelopment/ClawQL, clawql-mcp
- Звёзды
- 13
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 15 нояб. 2026 г.
- Лицензия
- Apache-2.0
Что такое ClawQL MCP?
Позволяет ИИ-агентам находить и выполнять API-операции с помощью эффективного по токенам рабочего процесса поиска и выполнения через OpenAPI, Google Discovery, GraphQL и gRPC.
Сводка сгенерирована из README проекта
О ClawQL MCP server
ClawQL выступает в роли агентного шлюза, разработанного для того, чтобы помогать ИИ-агентам находить и запускать API-операции через экономичный по токенам рабочий процесс поиска и выполнения. Он поддерживает различные протоколы, включая OpenAPI, Google Discovery, GraphQL и gRPC. Разработчики могут использовать его как MCP server в режимах stdio или HTTP, подключая к таким клиентам, как Cursor или Claude Desktop. Система спроектирована так, чтобы минимизировать использование контекстного окна, позволяя агентам искать конкретные операции перед их выполнением.
Платформа предлагает различные уровни функциональности, которые можно настроить через переменные окружения. Основные инструменты, такие как search, execute, audit и cache, всегда активны. Пользователи могут подключать дополнительные возможности, такие как управление памятью, загрузка документов и выполнение в песочнице. Для специфических интеграций, например Linear, пользователи могут предоставить LINEAR_API_KEY или указать GraphQL-эндпоинт. Сервер можно развернуть локально через npm или в контейнеризированных средах с помощью Docker и Kubernetes.
Что вы можете с ним делать
- 1Эффективный поиск APIИИ-агент может искать конкретные API-операции, чтобы избежать загрузки огромных файлов спецификаций в контекст промпта.
- 2Выполнение API через несколько протоколовРазработчик может дать агенту команду выполнять действия в различных сервисах, используя протоколы REST, GraphQL или gRPC.
- 3Управление знаниямиВы можете поручить агенту загрузку внешних документов или управление долгосрочной памятью с использованием хранилища Obsidian.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить ClawQL MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка ClawQL MCP в Claude Code
$ claude mcp add clawql -- npx -y clawql-mcpУстановка ClawQL MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"clawql": {
"command": "npx",
"args": [
"-y",
"clawql-mcp"
]
}
}
}Установка ClawQL MCP в VS Code
.vscode/mcp.json
{
"servers": {
"clawql": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"clawql-mcp"
]
}
}
}Установка ClawQL MCP в VS Code CLI
$ code --add-mcp '{"name":"clawql","type":"stdio","command":"npx","args":["-y","clawql-mcp"]}'Установка ClawQL MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"clawql": {
"command": "npx",
"args": [
"-y",
"clawql-mcp"
]
}
}
}Установка ClawQL MCP в Codex
$ codex mcp add clawql -- npx -y clawql-mcpУстановка ClawQL MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.clawql] command = "npx" args = ["-y", "clawql-mcp"]
Установка ClawQL MCP в Gemini CLI
$ gemini mcp add -s user clawql npx -- -y clawql-mcpУстановка ClawQL MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"clawql": {
"command": "npx",
"args": [
"-y",
"clawql-mcp"
]
}
}
}Конфигурация
CLAWQL_INSTANCE_SPECCLAWQL_PROVIDER
| Название | Описание | Тип |
|---|---|---|
| CLAWQL_INSTANCE_SPEC | — | |
| CLAWQL_PROVIDER | — |
Автоматические проверки
Запущено 13 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийПройдено
- Open source лицензия (OSI)Пройдено
- Коммит или релиз за последний годПройдено
- Имя пакета не похоже на популярный пакетПройдено
- Удаленная конечная точка использует HTTPSНе проверялось
- Деструктивные инструменты помеченыНе проверялось
- Нет скрытых инструкций для моделиПройдено
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
README
Открыть на GitHubClawQL
ClawQL provides the Agentic Gateway as the Foundational Platform for Auditable Production AI.
The Agentic Gateway is an MCP + OpenAI-compatible control plane for API discovery and execution with a token-efficient search -> execute workflow over OpenAPI, Google Discovery, and optional native GraphQL and gRPC sources (see CLAWQL_GRAPHQL_URL / CLAWQL_GRAPHQL_SOURCES / CLAWQL_GRPC_SOURCES in .env.example and ADR 0002). GraphQL-only vendors (e.g. Linear) need no OpenAPI spec: use CLAWQL_PROVIDER=linear (bundled SDL under providers/linear/ + LINEAR_API_KEY), or point CLAWQL_GRAPHQL_URL at their HTTP endpoint and auth headers, or load search from CLAWQL_GRAPHQL_SCHEMA_PATH / CLAWQL_GRAPHQL_INTROSPECTION_PATH (or per-source schemaPath / introspectionPath) when upstream introspection is disabled — without CLAWQL_SPEC_* / CLAWQL_PROVIDER, the default bundled REST specs are not loaded.
Enterprise topology: Zero-Trust Agentic Fabric (Regional Hubs · Dedicated Virtual Gateways · Edge Gateways). GTM: inference-first playbook.
What You Get
Feature tiers (aligned with the architecture diagram — details in docs/readme/configuration.md):
- ClawQL Core (always on — no opt-out):
search,execute,audit,cache— same band in the diagram; ring-buffer semantics forauditand LRU semantics forcacheindocs/mcp/enterprise-mcp-tools.mdanddocs/mcp/cache-tool.md. - Default on — opt out:
memory_ingest/memory_recall, and the document stack (ingest_external_knowledge, plusknowledge_search_onyxwhenCLAWQL_ENABLE_ONYX=1). UseCLAWQL_ENABLE_MEMORY=0orCLAWQL_ENABLE_DOCUMENTS=0to hide; vault path still required for real disk I/O on memory / ingest. - Default off — opt in:
sandbox_exec(CLAWQL_ENABLE_SANDBOX=1),schedule,notify,knowledge_search_onyx(needsCLAWQL_ENABLE_ONYX=1and documents on),ouroboros_*— seedocs/mcp/mcp-tools.md. When enabled,CLAWQL_SANDBOX_BACKEND: omit = bridge;auto= Seatbelt → Docker → bridge. - Stdio and HTTP MCP server modes
- Bundled provider specs for offline lookup and multi-provider workflows
Primary package: clawql-mcp (7.0.0 — Agentic Gateway entry; default stack, vault-first onboarding, opt-in operator scaffold — RELEASE_NOTES_v7.0.0.md · announcement drafts: docs/announcements/announcement-drafts-v7.0.0.md)
Repo: https://github.com/danielsmithdevelopment/ClawQL
Container images on GHCR (Docker / Helm)
Prebuilt images live on GitHub Container Registry under ghcr.io/danielsmithdevelopment/ (clawql-mcp, clawql-website, clawql-dashboard, clawql-panguard-mcp-bridge). They are supposed to be public so anyone can docker pull without credentials and Kubernetes defaults (Kyverno) can verify signatures. If docker pull returns denied, the registry package is still private — see docker/README.md § GHCR visibility (checklist + make ghcr-packages-public for maintainers).
Quick Start
Install:
npm install clawql-mcp
Run with a slim server (no bundled OpenAPI catalog loaded). Opt into the curated pack when you want it:
npx -p clawql-mcp clawql init --interactive # vault-first onboarding
npx -p clawql-mcp clawql mcp-config # MCP JSON for Cursor
# Optional curated pack (CF + GitHub + Slack + Linear + Notion + Onyx):
CLAWQL_INSTANCE_SPEC='{"providers":{"pack":"default"}}' npx -p clawql-mcp clawql-mcp
# Or: CLAWQL_PROVIDER=default npx -p clawql-mcp clawql-mcp
npx -p clawql-mcp clawql-mcp
For every bundled vendor plus Google top-50 and AWS top-50:
CLAWQL_PROVIDER=all-providers npx clawql-mcp
Then configure your MCP client (Cursor/Claude Desktop) to connect — or paste the agent setup prompt into your agent.
Documentation Map
Top-level docs index: docs/README.md
Start here
- Zero-Trust Agentic Fabric:
docs/architecture/zero-trust-agentic-fabric.md—/architecture/agentic-fabric - Getting started:
docs/readme/getting-started.md - Set up with your agent:
docs/getting-started/agent-setup-prompt.md· init walkthrough spec:docs/getting-started/clawql-init-walkthrough-spec.md - Plugins hub:
docs/plugins/README.md—/plugins - Configuration and env precedence:
docs/readme/configuration.md - Deployment and client config:
docs/readme/deployment.md(Kubernetes list linksdocs/deployment/docker-desktop-istio-observability.mdfor Istio + Prometheus/Grafana/Tempo/Kiali/OTel on Docker Desktop) - Benchmarks and case studies:
docs/readme/benchmarks.md - Development notes:
docs/readme/development.md - Tool workflow skills:
docs/skills/README.md
Core references
- Modularization ground truth:
docs/design/modularization-implementation-status.md - Plugin model & registry:
docs/design/clawql-plugin-model.md,docs/reference/clawql-plugin-registry.md - MCP tools and examples:
docs/mcp/mcp-tools.md - Workflow recipes:
docs/recipes/README.md - Memory and vault workflows:
docs/memory/memory-obsidian.md - Cache tool:
docs/mcp/cache-tool.md - Enterprise MCP notes (
auditthreat model, future metrics/governance):docs/mcp/enterprise-mcp-tools.md - Slack notify tool:
docs/mcp/notify-tool.md - Onyx knowledge tool:
docs/mcp/onyx-knowledge-tool.md - Ouroboros package and integration:
docs/ouroboros/clawql-ouroboros.md
Deployments
- Docker:
docker/README.md - Cloud Run:
docs/deployment/deploy-cloud-run.md - Kubernetes:
docs/deployment/deploy-k8s.md - Helm chart (
clawql-mcp):docs/deployment/helm.md - IDP umbrella chart (
clawql-idp):docs/deployment/clawql-idp-helm.md— full-stack profile viavalues-idp-full.yaml - IDP observability bundle:
docs/observability/README.md(Grafana dashboard + trace/metrics guide) - OpenClaw + Slack IDP runbook:
docs/openclaw/slack-first-idp-runbook.md - Agent PR → Argo CD GitOps:
docs/gitops/agent-pr-argocd-pipeline.md - Tailscale / Headscale (beginner guide):
docs/deployment/tailscale-and-headscale-for-clawql.md(website/tailscale) - Headscale runbook + ACL starter:
docs/deployment/headscale-tailnet.md,docs/deployment/headscale-acls-clawql.hujson
IDP (intelligent document processing)
Eight bundled vendors (Nextcloud, Docling, Tika, Gotenberg, Stirling, Paperless, Onyx, Coneshare) compose via search / execute or optional MCP tools (run_idp_pipeline, classify_document, extract_document). Hub: docs/providers/idp-pipeline.md · matrix: docs/roadmap/idp-master-requirements-matrix.md · OpenClaw profile: docs/openclaw/openclaw-idp-skill-profile.md
Security and supply chain
- Security overview and shipped controls:
docs/security/README.md - Golden image pipeline (CI → scan → push → sign → Kyverno enforcement):
docs/security/golden-image-pipeline.md - Defense in depth reference:
docs/security/clawql-security-defense-in-depth.md - Engineering deliverables matrix (shipped/partial/planned):
docs/security/clawql-security-defense-deliverables.md - Docker SBOM/sign/scan operator notes:
docker/README.md - npm publish hardening (pack → scan → publish, provenance):
docs/security/npm-supply-chain.md - Deploy-time image signature enforcement (admission / Kyverno):
docs/security/image-signature-enforcement.md
Providers and specs
- Provider matrix and presets:
providers/README.md - Google Discovery helpers:
docs/providers/google-apis-lookup.md - AWS top-50 preset:
docs/providers/aws-apis-lookup.md,docs/providers/aws-onboarding.md
Architecture (Short Version)
- Agent calls
searchto discover relevant operations without loading entire specs into prompt context. - Agent calls
executewith operation details. - For OpenAPI/Discovery operations: in single-spec mode, ClawQL prefers an internal OpenAPI-to-GraphQL path (REST fallback on failure); in multi-spec mode,
executeuses REST per owning spec. - For native operations (when configured):
executecalls HTTP GraphQL or gRPC unary directly — samesearchindex, routed by operation metadata — see ADR 0002.
Notes
- Core (
search,execute,audit,cache) has no opt-out — noCLAWQL_ENABLE_*gate for those tools. - A writable
CLAWQL_OBSIDIAN_VAULT_PATHis required to read/write the vault formemory_*and bulkingest_external_knowledge. - For full environment variable details, see
.env.exampleanddocs/mcp/mcp-tools.md.
Вопросы о ClawQL MCP
Как добавить ClawQL MCP в Claude Code?
Выполните claude mcp add clawql -- npx -y clawql-mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить ClawQL MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Как ClawQL обеспечивает поиск API для агентов?
Агенты вызывают инструмент поиска для обнаружения релевантных операций, что избавляет от необходимости загружать полные определения API в контекст промпта.
Какие протоколы поддерживает ClawQL для выполнения операций?
Он поддерживает OpenAPI, Google Discovery, нативный GraphQL и источники gRPC.
Можно ли использовать ClawQL с вендорами, работающими только через GraphQL, например Linear?
Да, вы можете использовать встроенный SDL для Linear, установив провайдера linear, или указать HTTP-эндпоинт с заголовками авторизации.
Какие основные инструменты нельзя отключить?
Основные инструменты включают search, execute, audit и cache; они всегда активны и не имеют возможности отключения.