[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_110":111},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":48,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":-5,"_64":-5,"_65":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":-5,"_76":-5,"_77":-5,"_78":48,"_79":-5,"_80":58,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92},"apiUrl","https://odel.app/api","creator","alias8818","moduleId","enoch-mcp","@alias8818/enoch-mcp","displayName","Enoch","tagline","Operate an Enoch control plane through MCP tools","iconKey","https://avatars.githubusercontent.com/u/1560348?v=4","category","local","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","pricingModel","free","creatorUserId","system:external-import","createdAt",1783337817000,"updatedAt",1786772871000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.alias8818%2Fenoch","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",0,"upstreamUpdatedAt",1785906628000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/alias8818/enoch-mcp","githubRepoFullName","alias8818/enoch-mcp","releaseId","ext-alias8818-enoch-mcp","version","0.1.1","descriptionMarkdown","# enoch-mcp\n\n\n\n![enoch-mcp bridge diagram](https://raw.githubusercontent.com/alias8818/enoch-mcp/main/assets/mcp-bridge.svg)\n\n**`enoch-mcp` is a local Model Context Protocol stdio server for a configured Enoch FastAPI control-plane API.** It lets MCP clients inspect and operate Enoch through typed tools without exposing a raw shell or reimplementing Enoch business logic.\n\n

\n Enoch system repo ·\n Docs ·\n MCP\n

\n\n## What it does\n\n- Registers MCP tools for Enoch control-plane, Dashboard V1, and core endpoints.\n- Sends requests to a configured Enoch API URL.\n- Adds `Authorization: Bearer ` to API requests using the configured token.\n- Returns Enoch API responses to the MCP client.\n- Marks read-only tools with MCP read-only annotations.\n- Marks mutating tools as non-read-only and adds approval metadata.\n- Keeps safe defaults for dry-run operations.\n- Optionally probes configured CPU/GPU workers directly through worker APIs or allowlisted SSH diagnostics.\n\n## What it does not do\n\n- It does not expose a raw shell tool.\n- It does not accept arbitrary SSH commands.\n- It does not read or write local artifact files directly.\n- It does not call language models.\n- It does not cache, retry, queue, or schedule work.\n- It does not bypass Enoch authentication or authorization.\n\n## Requirements\n\n- Python 3.11 or newer\n- A running Enoch API, normally at `http://localhost:8787`\n- An Enoch API bearer token\n- An MCP client that can run local stdio servers\n\n## Installation\n\nRun from PyPI with `uvx`:\n\n```bash\nuvx enoch-mcp --api-url http://localhost:8787 --api-token ''\n```\n\nOr configure with environment variables:\n\n```bash\nexport ENOCH_API_URL='http://localhost:8787'\nexport ENOCH_API_TOKEN=''\nuvx enoch-mcp\n```\n\nFor local development from a checkout:\n\n```bash\ngit clone https://github.com/alias8818/enoch-mcp.git\ncd enoch-mcp\nuv sync --dev\nuv run enoch-mcp --api-url http://localhost:8787 --api-token ''\n```\n\n## Configuration\n\n| Option | Environment variable | Default | Description |\n| --- | --- | --- | --- |\n| `--api-url` | `ENOCH_API_URL` | `http://localhost:8787` | Base URL for the Enoch API. |\n| `--api-token` | `ENOCH_API_TOKEN` | none | Bearer token for the Enoch API. |\n| `--worker-probes-json` | `ENOCH_WORKER_PROBES_JSON` | none | Optional JSON map for direct worker diagnostics. |\n| `--worker-probes-file` | `ENOCH_WORKER_PROBES_FILE` | none | Optional path to a JSON map for direct worker diagnostics. |\n\nThe token is required. If it is missing, tool calls fail before making an HTTP request.\n\n## Optional worker probes\n\nWorker probes are disabled unless `ENOCH_WORKER_PROBES_JSON` or `ENOCH_WORKER_PROBES_FILE` is configured. This keeps the default package a thin control-plane bridge. When configured, the MCP exposes named diagnostics for worker truth: API health, worker-gate dashboard status, active process markers, bounded log tails, disk space, and expected artifact presence.\n\nExample:\n\n```json\n{\n \"cpu\": {\n \"api_url\": \"http://127.0.0.1:18788\",\n \"api_token\": \"worker-api-token\",\n \"service_name\": \"enoch-control-plane\",\n \"project_root\": \"/srv/enoch/projects\"\n },\n \"gpu\": {\n \"api_url\": \"http://127.0.0.1:18789\",\n \"api_token\": \"worker-api-token\",\n \"ssh_host\": \"worker-gpu.example.internal\",\n \"ssh_user\": \"enoch\",\n \"service_name\": \"enoch-control-plane\",\n \"project_root\": \"/srv/enoch/projects\",\n \"log_paths\": [\"/var/log/enoch-control-plane.log\"]\n }\n}\n```\n\nSupported fields per lane:\n\n- `api_url`: worker-gate base URL. Used first for `/healthz`, `/dashboard/api`, `/dashboard/api/run/{run_id}`, and `/project-status/{project_id}`.\n- `api_token`: worker bearer token. Treated as secret.\n- `ssh_host`, `ssh_user`, `ssh_port`: optional SSH fallback/debug target.\n- `service_name`: systemd unit name for service checks and journal tails.\n- `project_root`, `state_dir`: fixed worker roots used for disk and artifact checks.\n- `log_paths`: fixed worker-gate log paths that may be tailed.\n\nSSH probes only run fixed diagnostic commands. They do not accept arbitrary shell input from the MCP client. User-supplied IDs are limited to safe run/project identifier characters, log output is bounded, SSH uses batch mode and no stdin, and the recommended deployment is a read-only worker user or forced-command policy.\n\n## MCP client setup\n\n### Claude Desktop\n\n```json\n{\n \"mcpServers\": {\n \"enoch\": {\n \"command\": \"uvx\",\n \"args\": [\"enoch-mcp\"],\n \"env\": {\n \"ENOCH_API_URL\": \"http://localhost:8787\",\n \"ENOCH_API_TOKEN\": \"replace-with-token\"\n }\n }\n }\n}\n```\n\nFor local development, point the MCP client at the checkout:\n\n```json\n{\n \"mcpServers\": {\n \"enoch\": {\n \"command\": \"uv\",\n \"args\": [\"--directory\", \"/path/to/enoch-mcp\", \"run\", \"enoch-mcp\"],\n \"env\": {\n \"ENOCH_API_URL\": \"http://localhost:8787\",\n \"ENOCH_API_TOKEN\": \"replace-with-token\"\n }\n }\n }\n}\n```\n\nUse the equivalent local stdio-server settings for Cursor, Copilot, Windsurf, or other MCP clients.\n\n## Development\n\n```bash\nuv sync --dev\nuv run pytest -q\ngitleaks detect --no-git --redact\n```\n\n## Public-safety note\n\nThis package is public. Examples must use placeholders and local URLs only. Do not publish private hostnames, LAN/Tailscale IPs, operator paths, or live tokens.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","iconType","image","upstream",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":66,"_104":105},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":58,"_94":58},"ratingAvg","reviewCount","topics",[],"license","MIT","language","Python","registryName","io.github.alias8818/enoch","homepage","packages",[106],{"_107":108,"_109":21,"_71":72},"registryType","pypi","identifier","ENV",{"_112":113,"_114":115,"_116":117},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]