@hiabhee/archdraw-mcp-server 1.0.5 → 1.0.6

package/README.md

@@ -0,0 +1,119 @@
+# @hiabhee/archdraw-mcp-server
+
+The MCP server for [ArchDraw](https://archdraw.hiabhee.online). It lets an AI agent make, change, validate, and export software architecture diagrams.
+
+The server uses the same Mermaid → Dagre layout pipeline as the ArchDraw editor. Each new diagram gets a preview link that you can open in a browser.
+
+This document uses ASD-STE100 Simplified Technical English.
+
+## Select a connection type
+
+| Connection type | Value | Use it when |
+| --- | --- | --- |
+| **Remote (HTTP)** | `https://archdraw.hiabhee.online/api/mcp` | The client can connect to a remote MCP server. This is the recommended type. You do not install this package. |
+| **Local (stdio)** | `npx -y @hiabhee/archdraw-mcp-server@1.0.6` | The client can only start a local process. |
+
+For the steps for each client (Claude Code, Claude apps, Codex, Cursor, VS Code, Gemini CLI, OpenCode, and others), refer to the [connection guide](https://archdraw.hiabhee.online/docs/connect-agents).
+
+## Use the local server
+
+### Requirements
+
+- Node.js 18 or later
+- Network access to `archdraw.hiabhee.online`
+
+### Configuration
+
+Most clients use this format:
+
+```json
+{
+  "mcpServers": {
+    "archdraw": {
+      "command": "npx",
+      "args": ["-y", "@hiabhee/archdraw-mcp-server@1.0.6"],
+      "env": {
+        "API_BASE_URL": "https://archdraw.hiabhee.online"
+      }
+    }
+  }
+}
+```
+
+> **CAUTION:** You must set `API_BASE_URL`. If you do not set it, the server starts and shows its tools, but `generate_diagram`, `fix_layout`, and preview links do not operate.
+
+### Environment variables
+
+| Variable | Necessary | Function |
+| --- | --- | --- |
+| `API_BASE_URL` | Yes | The ArchDraw web API that does the layout, publishes previews, and keeps sessions. Use `https://archdraw.hiabhee.online`, or the URL of your own deployment. |
+
+## Link a repository to a live project
+
+A live project is an ArchDraw canvas that shows which coding-agent session works on which component. To connect a repository to a live project:
+
+1. In the ArchDraw editor, open the canvas and select **Make live project**.
+2. In the repository, run:
+
+   ```bash
+   npx -y @hiabhee/archdraw-mcp-server@1.0.6 link --api https://archdraw.hiabhee.online
+   ```
+
+3. In the editor, select **Live project → Connect an agent** and enter the code that the command shows.
+
+The command keeps the link in `~/.archdraw/projects.json` (mode `0600`), outside the repository. The file contains a project token. Do not share it. Other commands:
+
+| Command | Result |
+| --- | --- |
+| `link --api <URL>` | Links the current repository (or its main repository, for a git worktree). |
+| `status` | Shows the project that the current repository is linked to. |
+| `unlink` | Removes the local link. To revoke the token, select **Stop** in the editor. |
+
+The ArchDraw plugin for Claude Code uses this link to report the files that each session edits. It sends file paths only.
+
+## Tools
+
+| Tool | Function |
+| --- | --- |
+| `read_me` | Gives the reference guide for the agent. The agent calls it first. |
+| `generate_diagram` | Makes a diagram from Mermaid text or from nodes and edges. |
+| `update_diagram` | Adds, removes, or changes nodes and edges in the current diagram. |
+| `get_diagram_state` | Gives the nodes and edges of the current diagram. |
+| `validate_diagram` | Finds structural problems and gives recommendations. |
+| `fix_layout` | Calculates the layout again with the ArchDraw editor pipeline. |
+| `apply_template` | Loads an architecture template. |
+| `list_templates` | Gives the list of templates. |
+| `list_node_types` | Gives the list of component types in the ArchDraw library. |
+| `save_checkpoint` | Saves the current diagram with a name. |
+| `load_checkpoint` | Restores a saved diagram. |
+| `export_diagram` | Exports the diagram as JSON, PNG, or SVG. |
+
+## Data and privacy
+
+- The server sends the diagram content that the agent gives it to `API_BASE_URL`. This includes component names, labels, connections, and Mermaid text. The server does not read your source files.
+- Each new diagram gets a preview link by default. Anyone with the link can see the diagram. The link expires after 7 days. To prevent a link, tell the agent to keep the diagram private (`publish: false`).
+- The local server keeps the working diagram and its checkpoints in memory. It discards them when the process stops.
+
+> **WARNING:** Do not put passwords, API keys, or other secrets in diagram labels.
+
+Refer to the [privacy policy](https://archdraw.hiabhee.online/privacy).
+
+## Use the server in your own code
+
+The package exports a server factory for Streamable HTTP hosts:
+
+```ts
+import { createArchDrawMCPServer, handleMcpHttpRequest } from '@hiabhee/archdraw-mcp-server/server';
+```
+
+The hosted endpoint at `/api/mcp` uses this export.
+
+## Links
+
+- [Source code](https://github.com/hiabhee/ArchDraw/tree/main/mcp-server)
+- [Connection guide](https://archdraw.hiabhee.online/docs/connect-agents)
+- [Issues](https://github.com/hiabhee/ArchDraw/issues)
+
+## License
+
+MIT

package/dist/cli/project-link.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `archdraw-mcp-server link|unlink|status` — pair this git checkout with an
+ * ArchDraw live project. Pairing uses the browser approval flow
+ * (`/api/agentic/pairing`): the CLI shows a code, the user enters it in the
+ * editor's Live project panel, and the CLI receives a project-scoped token.
+ * Output goes to stderr except the final machine-readable line.
+ */
+export declare const PROJECT_COMMANDS: Set<string>;
+interface CliIO {
+    log: (message: string) => void;
+    fetch: typeof fetch;
+    sleep: (ms: number) => Promise<void>;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}
+export declare function runProjectCommand(command: string, argv: string[], io?: CliIO): Promise<number>;
+export {};
+//# sourceMappingURL=project-link.d.ts.map

package/dist/cli/project-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-link.d.ts","sourceRoot":"","sources":["../../src/cli/project-link.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,eAAO,MAAM,gBAAgB,aAAwC,CAAC;AAItE,UAAU,KAAK;IACb,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AA0HD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAKjH"}

package/dist/cli/project-link.js

@@ -0,0 +1,129 @@
+import { getBinding, removeBinding, resolveRepoRoot, saveBinding, bindingFilePath } from '../lib/project-binding.js';
+/**
+ * `archdraw-mcp-server link|unlink|status` — pair this git checkout with an
+ * ArchDraw live project. Pairing uses the browser approval flow
+ * (`/api/agentic/pairing`): the CLI shows a code, the user enters it in the
+ * editor's Live project panel, and the CLI receives a project-scoped token.
+ * Output goes to stderr except the final machine-readable line.
+ */
+export const PROJECT_COMMANDS = new Set(['link', 'unlink', 'status']);
+const POLL_INTERVAL_MS = 3000;
+const defaultIO = () => ({
+    log: (message) => process.stderr.write(`${message}\n`),
+    fetch,
+    sleep: (ms) => new Promise((r) => setTimeout(r, ms)),
+    cwd: process.cwd(),
+    env: process.env,
+});
+function parseArgs(argv) {
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith('--')) {
+            const [key, inline] = arg.slice(2).split('=', 2);
+            flags[key] = inline ?? argv[++i] ?? '';
+        }
+    }
+    return flags;
+}
+function formatUserCode(code) {
+    return code.match(/.{1,4}/g)?.join('-') ?? code;
+}
+function normalizeApiBase(value) {
+    if (!value)
+        return null;
+    try {
+        const url = new URL(value);
+        if (url.protocol !== 'https:' && !['localhost', '127.0.0.1'].includes(url.hostname))
+            return null;
+        return url.origin;
+    }
+    catch {
+        return null;
+    }
+}
+async function link(flags, io) {
+    const apiBase = normalizeApiBase(flags.api || io.env.API_BASE_URL);
+    if (!apiBase) {
+        io.log('Pass the ArchDraw URL: link --api https://archdraw.hiabhee.online (https, or http://localhost for development).');
+        return 2;
+    }
+    const repoRoot = resolveRepoRoot(io.cwd);
+    const start = await io.fetch(`${apiBase}/api/agentic/pairing`, { method: 'POST' });
+    if (!start.ok) {
+        io.log(`Could not start pairing (${start.status}).`);
+        return 1;
+    }
+    const pairing = (await start.json());
+    io.log('');
+    io.log(`Linking ${repoRoot} to an ArchDraw live project.`);
+    io.log(`Open your project canvas in ArchDraw → Live project → Connect an agent, and enter:`);
+    io.log('');
+    io.log(`    ${formatUserCode(pairing.userCode)}`);
+    io.log('');
+    io.log(`Waiting for approval (expires ${new Date(pairing.expiresAt).toLocaleTimeString()})…`);
+    const deadline = new Date(pairing.expiresAt).getTime();
+    while (Date.now() < deadline) {
+        await io.sleep(POLL_INTERVAL_MS);
+        const res = await io.fetch(`${apiBase}/api/agentic/pairing/poll`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ pairingId: pairing.pairingId, pollToken: pairing.pollToken }),
+        });
+        if (res.status === 202)
+            continue;
+        if (res.status === 410)
+            break;
+        const body = (await res.json().catch(() => ({})));
+        if (res.ok && body.status === 'complete' && body.projectId && body.workspaceId) {
+            if (!body.canvasId) {
+                io.log('Approved, but that project is not linked to a canvas. Use "Make live project" on a canvas and try again.');
+                return 1;
+            }
+            saveBinding(repoRoot, {
+                apiBase,
+                canvasId: body.canvasId,
+                agenticProjectId: body.projectId,
+                workspaceId: body.workspaceId,
+                token: pairing.pollToken,
+                linkedAt: new Date().toISOString(),
+            });
+            io.log(`Linked. Credentials saved to ${bindingFilePath()} (outside the repository).`);
+            io.log(`Project canvas: ${apiBase}/editor?canvas=${encodeURIComponent(body.canvasId)}`);
+            return 0;
+        }
+        if (!res.ok && res.status !== 409) {
+            io.log(`Pairing failed (${res.status}).`);
+            return 1;
+        }
+    }
+    io.log('Pairing code expired. Run link again.');
+    return 1;
+}
+function unlink(io) {
+    const repoRoot = resolveRepoRoot(io.cwd);
+    const removed = removeBinding(repoRoot);
+    io.log(removed
+        ? `Unlinked ${repoRoot}. To revoke the credential too, use "Stop" in the editor's Live project panel.`
+        : `${repoRoot} is not linked.`);
+    return 0;
+}
+function status(io) {
+    const repoRoot = resolveRepoRoot(io.cwd);
+    const binding = getBinding(repoRoot);
+    if (!binding) {
+        io.log(`${repoRoot} is not linked to an ArchDraw project.`);
+        return 1;
+    }
+    io.log(`${repoRoot} → ${binding.apiBase}/editor?canvas=${encodeURIComponent(binding.canvasId)} (linked ${binding.linkedAt})`);
+    return 0;
+}
+export async function runProjectCommand(command, argv, io = defaultIO()) {
+    const flags = parseArgs(argv);
+    if (command === 'link')
+        return link(flags, io);
+    if (command === 'unlink')
+        return unlink(io);
+    return status(io);
+}
+//# sourceMappingURL=project-link.js.map

package/dist/cli/project-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-link.js","sourceRoot":"","sources":["../../src/cli/project-link.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,8 +1,20 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { createArchDrawMCPServer } from './server.js';
-const server = createArchDrawMCPServer();
-server.connect(new StdioServerTransport())
-    .then(() => console.error('ArchDraw MCP server running on stdio'))
-    .catch(console.error);
+import { PROJECT_COMMANDS, runProjectCommand } from './cli/project-link.js';
+const command = process.argv[2];
+if (command && PROJECT_COMMANDS.has(command)) {
+    runProjectCommand(command, process.argv.slice(3))
+        .then((code) => process.exit(code))
+        .catch((error) => {
+        console.error(error instanceof Error ? error.message : error);
+        process.exit(1);
+    });
+}
+else {
+    const server = createArchDrawMCPServer();
+    server.connect(new StdioServerTransport())
+        .then(() => console.error('ArchDraw MCP server running on stdio'))
+        .catch(console.error);
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;AACzC,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC;KACvC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;KACjE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE5E,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChC,IAAI,OAAO,IAAI,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7C,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC9C,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAClC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC;KAAM,CAAC;IACN,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;IACzC,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC;SACvC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;SACjE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC"}

package/dist/lib/project-binding.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Local link between a git checkout and an ArchDraw live project canvas.
+ * Stored outside the repository (never committed) in
+ * `~/.archdraw/projects.json`, mode 0600. The plugin hook script reads the
+ * same file — keep the format stable (`version: 1`).
+ */
+export interface ProjectBinding {
+    apiBase: string;
+    canvasId: string;
+    agenticProjectId: string;
+    workspaceId: string;
+    /** Project-scoped `adp_` agent credential. Never print or log it. */
+    token: string;
+    linkedAt: string;
+}
+interface BindingFile {
+    version: 1;
+    projects: Record<string, ProjectBinding>;
+}
+export declare function archdrawHome(): string;
+export declare function bindingFilePath(): string;
+/** Repository root for `cwd` (git top-level), falling back to cwd itself. */
+export declare function resolveRepoRoot(cwd?: string): string;
+export declare function readBindings(): BindingFile;
+export declare function getBinding(repoRoot: string): ProjectBinding | undefined;
+export declare function saveBinding(repoRoot: string, binding: ProjectBinding): void;
+export declare function removeBinding(repoRoot: string): boolean;
+export {};
+//# sourceMappingURL=project-binding.d.ts.map

package/dist/lib/project-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-binding.d.ts","sourceRoot":"","sources":["../../src/lib/project-binding.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,WAAW;IACnB,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC1C;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAMnE;AAED,wBAAgB,YAAY,IAAI,WAAW,CAS1C;AAYD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEvE;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,QAIpE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMvD"}

package/dist/lib/project-binding.js

@@ -0,0 +1,57 @@
+import { execFileSync } from 'node:child_process';
+import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+export function archdrawHome() {
+    return process.env.ARCHDRAW_HOME || join(homedir(), '.archdraw');
+}
+export function bindingFilePath() {
+    return join(archdrawHome(), 'projects.json');
+}
+/** Repository root for `cwd` (git top-level), falling back to cwd itself. */
+export function resolveRepoRoot(cwd = process.cwd()) {
+    try {
+        return execFileSync('git', ['rev-parse', '--show-toplevel'], { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+    }
+    catch {
+        return resolve(cwd);
+    }
+}
+export function readBindings() {
+    const path = bindingFilePath();
+    if (!existsSync(path))
+        return { version: 1, projects: {} };
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        return { version: 1, projects: parsed.projects && typeof parsed.projects === 'object' ? parsed.projects : {} };
+    }
+    catch {
+        return { version: 1, projects: {} };
+    }
+}
+function writeBindings(file) {
+    const dir = archdrawHome();
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const path = bindingFilePath();
+    const tmp = `${path}.${process.pid}.tmp`;
+    writeFileSync(tmp, `${JSON.stringify(file, null, 2)}\n`, { mode: 0o600 });
+    renameSync(tmp, path);
+    chmodSync(path, 0o600);
+}
+export function getBinding(repoRoot) {
+    return readBindings().projects[repoRoot];
+}
+export function saveBinding(repoRoot, binding) {
+    const file = readBindings();
+    file.projects[repoRoot] = binding;
+    writeBindings(file);
+}
+export function removeBinding(repoRoot) {
+    const file = readBindings();
+    if (!file.projects[repoRoot])
+        return false;
+    delete file.projects[repoRoot];
+    writeBindings(file);
+    return true;
+}
+//# sourceMappingURL=project-binding.js.map

package/dist/lib/project-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-binding.js","sourceRoot":"","sources":["../../src/lib/project-binding.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -2,7 +2,7 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { type DiagramState } from './lib/diagram-state.js';
 import { type Checkpoint } from './lib/checkpoints.js';
 import { runWithMcpContext, type McpRequestContext } from './lib/http.js';
-export declare const SERVER_VERSION = "1.0.5";
+export declare const SERVER_VERSION = "1.0.6";
 /** Everything a working session holds between tool calls. */
 export interface WorkingSessionSnapshot {
     diagram: DiagramState | null;

package/dist/server.js

@@ -525,7 +525,7 @@ Useful for multi-turn workflows: save before a major change, restore if needed.`
         },
     },
 ];
-export const SERVER_VERSION = '1.0.5';
+export const SERVER_VERSION = '1.0.6';
 const STATEFUL_TOOLS = new Set([
     'generate_diagram',
     'apply_template',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hiabhee/archdraw-mcp-server",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "MCP server for ArchDraw architecture diagramming tool",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",