English Français العربية

io.github.ElliotPadfield/hatchet-mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

Observe and operate Hatchet workflows from an AI agent — runs, logs, trigger, cancel, replay.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package hatchet-mcp
Claude Code 
claude mcp add hatchet-mcp -e 'HATCHET_CLIENT_TOKEN=<your hatchet_client_token>' -e 'HATCHET_API_BASE=<HATCHET_API_BASE>' -e 'HATCHET_TENANT_ID=<HATCHET_TENANT_ID>' -- npx -y hatchet-mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "hatchet-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "hatchet-mcp@0.1.1"
            ],
            "env": {
                "HATCHET_CLIENT_TOKEN": "<your hatchet_client_token>",
                "HATCHET_API_BASE": "<HATCHET_API_BASE>",
                "HATCHET_TENANT_ID": "<HATCHET_TENANT_ID>"
            }
        }
    }
}

متغيرات البيئة

  • HATCHET_CLIENT_TOKEN إلزامي سري Hatchet API token (a JWT). Encodes the server URL and tenant, so it is normally the only setting required.
  • HATCHET_API_BASE Override the API base URL. Self-hosters can point this at any Hatchet instance.
  • HATCHET_TENANT_ID Override the tenant id decoded from the token.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. hatchet-mcp
  2. Install
  3. Configuration
  4. Tools
  5. Safety
  6. Development
  7. Status

hatchet-mcp

An MCP server that lets AI agents observe and operate Hatchet workflows — status, runs, logs, workers, and metrics, plus trigger / cancel / replay.

Why: Hatchet has a great API but no MCP. This wraps it so agents (Claude Code / Desktop, etc.) can see and act on workflow state.

Install

Add this to your Claude Code / Claude Desktop MCP config:

{
  "mcpServers": {
    "hatchet": {
      "command": "npx",
      "args": ["-y", "hatchet-mcp"],
      "env": { "HATCHET_CLIENT_TOKEN": "<your-hatchet-api-token>" }
    }
  }
}

Get the token from the Hatchet dashboard → API tokens. The token is a JWT that encodes the server URL and tenant, so it's the only required setting.

Configuration

VariableRequiredDescription
HATCHET_CLIENT_TOKENYesHatchet API token (JWT). Encodes the server URL + tenant, so it's normally all you need.
HATCHET_API_BASENoOverride the API base URL. Self-hosters can point this at any Hatchet instance.
HATCHET_TENANT_IDNoOverride the tenant id decoded from the token.

Self-hosting? Set HATCHET_API_BASE to your own Hatchet instance and it works anywhere.

Tools

Observability (read-only)
ToolDescription
whoamiShow the resolved Hatchet tenant + server URL and confirm the token works.
list_workflowsList workflow definitions for the tenant.
list_runsList workflow runs (with an optional lookback window and filters).
get_runGet the full detail of one workflow run — status, tasks, errors.
get_run_logsGet log lines for a task by its external id.
list_workersList workers and their status.
get_queue_metricsGet task/queue metrics for the tenant (queue health).
Actions (mutate live state)
ToolDescription
trigger_workflowTrigger a new workflow run by name with a JSON input payload.
cancel_runsCancel one or more runs/tasks by external id.
replay_runsReplay/retry one or more runs/tasks by external id.

Safety

The read tools (whoami, list_workflows, list_runs, get_run, get_run_logs, list_workers, get_queue_metrics) are non-destructive.

trigger_workflow, cancel_runs, and replay_runs mutate live state — their descriptions are prefixed MUTATES LIVE STATE so agents and users know they affect real runs.

The token grants full tenant access — treat it as a secret. Never commit it to source control.

Development

pnpm install
pnpm test    # vitest
pnpm build   # tsup -> dist/index.js

TypeScript / ESM, tested with vitest.

Status

v0.1.0 — all tools verified against Hatchet Cloud; works with self-hosted instances via HATCHET_API_BASE. trigger_workflow uses the stable /workflow-runs/trigger endpoint.

الأسئلة الشائعة

ما هو io.github.ElliotPadfield/hatchet-mcp؟

Observe and operate Hatchet workflows from an AI agent — runs, logs, trigger, cancel, replay.

كيف أثبّت io.github.ElliotPadfield/hatchet-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add hatchet-mcp -e 'HATCHET_CLIENT_TOKEN=<your hatchet_client_token>' -e 'HATCHET_API_BASE=<HATCHET_API_BASE>' -e 'HATCHET_TENANT_ID=<HATCHET_TENANT_ID>' -- npx -y hatchet-mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.ElliotPadfield/hatchet-mcp إلى مفتاح API؟

نعم. يتطلب HATCHET_CLIENT_TOKEN، وتضبطها في إعداداته.

هل io.github.ElliotPadfield/hatchet-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.ElliotPadfield/hatchet-mcp؟

ينشره ElliotPadfield. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.