@tempo-ai/mcp 0.0.100-staging.1

package/README.md

@@ -0,0 +1,62 @@
+# @tempo-ai/mcp
+
+Tempo's MCP server for external hosts — Claude Code, Codex CLI, Cursor, and
+any other MCP-compatible client. ONE server entry exposes Tempo's full tool
+surface: issues, cloud docs, canvas comments, custom agents, run scripts,
+Slack (as the org's Tempo bot), Linear, and — when run inside a Tempo repo —
+the canvas tools, including headless `canvas_screenshot` and `canvas_share`
+with real preview capture.
+
+## Install
+
+Claude Code:
+
+```bash
+claude mcp add tempo -- npx -y @tempo-ai/mcp
+```
+
+Codex (`~/.codex/config.toml`):
+
+```toml
+[mcp_servers.tempo]
+command = "npx"
+args = ["-y", "@tempo-ai/mcp"]
+```
+
+Cursor / generic JSON config:
+
+```json
+{ "tempo": { "command": "npx", "args": ["-y", "@tempo-ai/mcp"] } }
+```
+
+Sign in once (or let the first tool call prompt you):
+
+```bash
+npx @tempo-ai/mcp login
+```
+
+## Scoping model
+
+Identity comes from your sign-in; SCOPE is explicit on every call. Each
+issues/docs/comments/agents/scripts/slack/linear tool requires an `orgId`
+argument, and project-scoped tools require `projectId` — the AI discovers
+both with the built-in `tempo_list_orgs` / `tempo_list_projects` tools.
+Nothing org-related is ever baked into the connection config, and Tempo's
+backend re-validates org membership on every function call regardless.
+
+## Flags
+
+- `--toolsets issues,docs,canvas` — serve only the named toolsets
+- `--readonly` — register no write tools at all (also `TEMPO_MCP_READONLY=1`)
+
+## Canvas visuals
+
+`canvas_screenshot` / `canvas_share` spawn a disposable canvas devserver and
+capture with headless Chromium (the same pipeline Tempo's visual-review CI
+uses). They require Playwright's Chromium once per machine:
+
+```bash
+npx playwright install chromium
+```
+
+Share links require the canvas's branch to be committed and pushed.

package/dist/bin.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { createRequire as __tempoCreateRequire } from 'node:module'; const require = __tempoCreateRequire(import.meta.url);
+import {
+  run
+} from "./chunk-QTTJRK4J.js";
+import "./chunk-JDPG7F4Z.js";
+
+// src/bin.ts
+run(process.argv).then(
+  (code) => {
+    if (typeof code === "number") process.exit(code);
+  },
+  (err) => {
+    console.error(err instanceof Error ? err.stack || err.message : err);
+    process.exit(1);
+  }
+);
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Production CLI entrypoint shipped in the npm tarball.\n *\n * In source form (this file) it imports the dispatcher via the\n * relative path `./index.ts`. tsup bundles it to `dist/bin.js`\n * alongside `dist/index.js`, and the `bin` field in `package.json`\n * points at `./dist/bin.js`. Consumers running `npx tempo-mcp` or\n * `tempo-mcp <subcommand>` execute the bundled JS — no need for\n * `--experimental-strip-types` on their end.\n */\n\nimport { run } from \"./index.ts\";\n\nrun(process.argv).then(\n  (code) => {\n    // Long-running MCP servers never resolve `run()` until the host\n    // disconnects stdio. Short-lived commands (login/whoami/orgs) return\n    // here with the exit code.\n    if (typeof code === \"number\") process.exit(code);\n  },\n  (err) => {\n    console.error(err instanceof Error ? err.stack || err.message : err);\n    process.exit(1);\n  },\n);\n"],"mappings":";;;;;;;;AAcA,IAAI,QAAQ,IAAI,EAAE;AAAA,EAChB,CAAC,SAAS;AAIR,QAAI,OAAO,SAAS,SAAU,SAAQ,KAAK,IAAI;AAAA,EACjD;AAAA,EACA,CAAC,QAAQ;AACP,YAAQ,MAAM,eAAe,QAAQ,IAAI,SAAS,IAAI,UAAU,GAAG;AACnE,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}