@imqueue/mcp 1.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+@imqueue/mcp — Model Context Protocol server for @imqueue
+Copyright (C) 2026 imqueue.com
+
+This program is free software: you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free Software
+Foundation, either version 3 of the License, or (at your option) any later
+version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT ANY
+WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+PARTICULAR PURPOSE. See the GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License along with
+this program. If not, see <https://www.gnu.org/licenses/gpl-3.0.html>.
+
+Commercial licensing and support for use in closed-source products is available
+at https://imqueue.com.
+
+NOTE: replace this notice with the full GPL-3.0 license text before publishing
+(https://www.gnu.org/licenses/gpl-3.0.txt).

package/README.md

@@ -0,0 +1,65 @@
+# @imqueue/mcp
+
+A [Model Context Protocol](https://modelcontextprotocol.io) server for **[@imqueue](https://imqueue.org)**. It lets AI coding agents (Claude Code, Cursor, Windsurf, VS Code, …) **search the @imqueue documentation** and **scaffold typed services & clients** — so they generate correct, idiomatic @imqueue code instead of guessing.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `search_docs` | Search the official docs (guides, tutorial, CLI manual, API reference, articles) and return the most relevant pages + URLs. |
+| `get_doc` | Fetch the full markdown of a doc page by URL. |
+| `list_packages` | List the main @imqueue packages with install commands. |
+| `scaffold_service` | Generate an `IMQService` subclass with `@expose()`d, JSDoc-typed methods + a bootstrap. |
+| `scaffold_client` | Show how to generate and use the fully-typed client for a service. |
+
+Docs are fetched live from imqueue.org's machine-readable feeds (`/llms.txt`, per-page `…/index.md` mirrors), so the server never ships stale content. It only ever fetches `imqueue.org`.
+
+## Install
+
+Requires Node.js ≥ 18. No build step for users — run straight from npm:
+
+```bash
+npx -y @imqueue/mcp
+```
+
+### Claude Code
+
+```bash
+claude mcp add imqueue -- npx -y @imqueue/mcp
+```
+
+### Cursor / Windsurf / VS Code / Claude Desktop
+
+Add to your MCP config (`.cursor/mcp.json`, `claude_desktop_config.json`, …):
+
+```json
+{
+  "mcpServers": {
+    "imqueue": {
+      "command": "npx",
+      "args": ["-y", "@imqueue/mcp"]
+    }
+  }
+}
+```
+
+## Develop
+
+```bash
+npm install
+npm run build      # tsc -> dist/
+npm run dev        # run from source with tsx
+npm run smoke      # JSON-RPC handshake + tools/list + tool calls
+```
+
+## Example
+
+> **User:** *"Create an @imqueue user service with a getUser(id) method."*
+>
+> The agent calls `scaffold_service({ name: "user", methods: [{ name: "getUser", params: [{ name: "id", type: "number" }], returns: "User" }] })` and gets a ready-to-paste `UserService` + bootstrap, then `search_docs("run a service")` / `get_doc(...)` to wire it up.
+
+## License
+
+GPL-3.0. Commercial licensing & support for closed-source products: [imqueue.com](https://imqueue.com).
+
+See [SPEC.md](./SPEC.md) for the full design and registry-distribution plan.

package/SPEC.md

@@ -0,0 +1,119 @@
+# @imqueue/mcp — design spec
+
+## 1. Purpose
+
+Make @imqueue **first-class inside AI coding agents**. When a developer asks their
+assistant to "build an @imqueue service" or "how do I expose a method", the agent
+should reach for authoritative docs and correct scaffolding rather than
+hallucinating an API. This is the GEO (Generative Engine Optimization) counterpart
+to SEO: instead of ranking in a search page, we rank **at code-time**, inside the
+tools developers already use.
+
+Two capabilities, five tools:
+
+- **Docs access** — `search_docs`, `get_doc`, `list_packages`
+- **Scaffolding** — `scaffold_service`, `scaffold_client`
+
+## 2. Architecture
+
+```
+AI agent (Claude Code / Cursor / …)
+        │  MCP (JSON-RPC over stdio)
+        ▼
+  @imqueue/mcp  ── fetch ──▶  imqueue.org
+   ├─ docs.ts       (/llms.txt, /<page>/index.md)
+   ├─ packages.ts   (static catalog)
+   └─ scaffold.ts   (code templates)
+```
+
+- **Transport:** stdio (the universal local-MCP transport; works with every host
+  today). A hosted **Streamable HTTP** variant is a later option (§7).
+- **Runtime:** Node ≥ 18, TypeScript, `@modelcontextprotocol/sdk` high-level
+  `McpServer`, `zod` input schemas. Ships as an npm bin (`npx -y @imqueue/mcp`).
+- **Docs source:** fetched live from imqueue.org's existing machine-readable feeds
+  and cached in-process (1 h TTL). No docs are bundled, so the server can never go
+  stale against a release. **Only `imqueue.org` is ever fetched** (host-checked).
+
+### Why reuse the site feeds
+imqueue.org already emits, for GEO:
+- `/llms.txt` — curated index (`## Section` + `- [Title](url): description`)
+- `/<page-url>index.md` — a plain-markdown mirror of every page
+- `/blog/search-index.json` — structured post index
+
+The MCP server is a thin, agent-facing adapter over those — one source of truth.
+
+## 3. Tools
+
+### `search_docs(query, limit?=6)`
+Parse `/llms.txt` into `{title, url, description, section}` entries; rank by query-term
+overlap (title ×3, section/description/url ×1); return the top *N* with URLs.
+→ *"how do I expose a method" → the RPC guide + API pages.*
+
+### `get_doc(url)`
+Resolve a page URL to its markdown mirror (`…/index.md`) and return the raw markdown
+for reading/quoting. Host-restricted to imqueue.org.
+
+### `list_packages()`
+Static catalog (rpc, core, cli, job, pg-pubsub, pg-cache, async-logger, http-protect)
+with one-liners + install commands, so the agent picks the right package first.
+
+### `scaffold_service(name, methods?)`
+Emit an `IMQService` subclass with `@expose()`d, **JSDoc-typed** methods (JSDoc is
+@imqueue's type source) + a bootstrap that `start()`s it. Omitting `methods` yields a
+starter template. Points to `imq service create` for a fully provider-wired project.
+
+### `scaffold_client(service, methods?)`
+@imqueue generates the **real** typed client from a **running** service
+(`imq client generate <Name>`), so types never drift. The tool returns that command
+plus an illustrative usage snippet (it does not fabricate a client that could go stale).
+
+## 4. Input schemas (zod)
+
+- `search_docs`: `{ query: string, limit?: 1..20 }`
+- `get_doc`: `{ url: string }`
+- `list_packages`: `{}`
+- `scaffold_service` / `scaffold_client`: `{ name|service: string, methods?: Method[] }`
+  where `Method = { name, description?, params?: {name,type,description?}[], returns? }`.
+
+Every tool returns `{ content: [{ type: "text", text }] }`; errors return the same
+shape with `isError: true` (so the agent sees a message, not a transport failure).
+
+## 5. Distribution to registries
+
+Publish `@imqueue/mcp` to npm, then list it everywhere agents discover servers:
+
+| Channel | Artifact / action |
+|---|---|
+| **Official MCP registry** | `server.json` (this repo) → publish via `mcp-publisher`. Namespace `io.github.imqueue/mcp`. |
+| **Smithery** | `smithery.yaml` (this repo) → connect the GitHub repo. |
+| **mcp.so / PulseMCP / Glama** | Auto-index from npm + GitHub; submit/claim the listing. |
+| **Cursor / VS Code directories** | Add the `mcpServers` JSON snippet to their community lists. |
+| **awesome-mcp-servers** | PR the repo into the list. |
+| **imqueue.org** | Add an "MCP server" section to `/using-ai-assistants/` with the install snippet. |
+
+Install snippet promoted everywhere:
+```json
+{ "mcpServers": { "imqueue": { "command": "npx", "args": ["-y", "@imqueue/mcp"] } } }
+```
+
+## 6. Verification
+
+`npm run smoke` spawns the built server and drives the JSON-RPC handshake:
+`initialize` → `tools/list` (asserts all five) → `tools/call` for `scaffold_service`
+and `list_packages` (offline) and `search_docs` (live). CI can run it on every push.
+
+## 7. Roadmap
+
+- **Streamable HTTP** deployment (a hosted endpoint) for zero-install use and for
+  hosts that prefer remote servers.
+- **`generate_client` for real** — spin up against a reachable running service and
+  return the actual generated client.
+- **Resources** — expose docs pages as MCP *resources* (not just tool results) so
+  hosts can surface them in their UI.
+- **Prompts** — ship an "author an @imqueue service" prompt template.
+- **Richer search** — fold in `/blog/search-index.json` topics and light stemming to
+  improve recall (e.g. "delayed jobs" → job/scheduling pages).
+
+## 8. Licensing
+
+GPL-3.0, matching the framework; commercial licensing via imqueue.com.

package/dist/docs.d.ts

@@ -0,0 +1,17 @@
+export interface DocEntry {
+    title: string;
+    url: string;
+    description: string;
+    section: string;
+}
+/** Fetch + parse /llms.txt into a flat list of doc entries (cached). */
+export declare function loadIndex(): Promise<DocEntry[]>;
+/** Rank doc entries by overlap of query terms with title (weighted), section, description and url. */
+export declare function searchDocs(query: string, limit?: number): Promise<DocEntry[]>;
+/** Resolve a page URL/path to its markdown-mirror URL (`<page-url>index.md`). */
+export declare function mirrorUrl(pageUrl: string): string;
+/** Fetch the full markdown of a doc page by its page URL or path. */
+export declare function getDoc(pageUrl: string): Promise<{
+    url: string;
+    markdown: string;
+}>;

package/dist/docs.js

@@ -0,0 +1,103 @@
+// Docs access for the @imqueue MCP server.
+//
+// The docs live on imqueue.org as machine-readable feeds:
+//   * /llms.txt              — curated index: `## Section` + `- [Title](url): description`
+//   * /<page-url>index.md    — a plain-markdown mirror of every page
+//   * /blog/search-index.json — [{ title, url, summary, topics, ... }]
+//
+// We fetch these at runtime (so the server never ships stale copies) and cache
+// them in-process. Only imqueue.org is ever fetched.
+const SITE = "https://imqueue.org";
+const TTL_MS = 60 * 60 * 1000; // 1h in-process cache
+let indexCache = null;
+function assertImqueueUrl(u) {
+    const url = new URL(u, SITE);
+    if (url.hostname !== "imqueue.org") {
+        throw new Error(`Refusing to fetch non-imqueue.org URL: ${url.href}`);
+    }
+    return url;
+}
+/** Fetch + parse /llms.txt into a flat list of doc entries (cached). */
+export async function loadIndex() {
+    if (indexCache && Date.now() - indexCache.at < TTL_MS)
+        return indexCache.entries;
+    const res = await fetch(`${SITE}/llms.txt`);
+    if (!res.ok)
+        throw new Error(`Failed to fetch llms.txt (HTTP ${res.status})`);
+    const text = await res.text();
+    const entries = [];
+    let section = "General";
+    for (const line of text.split("\n")) {
+        const h = line.match(/^##\s+(.+?)\s*$/);
+        if (h) {
+            section = h[1].trim();
+            continue;
+        }
+        const m = line.match(/^-\s+\[([^\]]+)\]\(([^)]+)\)(?::\s*(.*))?$/);
+        if (m) {
+            entries.push({
+                title: m[1].trim(),
+                url: m[2].trim(),
+                description: (m[3] || "").trim(),
+                section,
+            });
+        }
+    }
+    indexCache = { at: Date.now(), entries };
+    return entries;
+}
+const STOP = new Set([
+    "the", "a", "an", "and", "or", "of", "to", "in", "for", "on", "with",
+    "is", "are", "how", "do", "does", "i", "my", "me", "it", "that", "this",
+]);
+function tokenize(s) {
+    return s
+        .toLowerCase()
+        .split(/[^a-z0-9@/+.-]+/)
+        .filter((t) => t.length > 1 && !STOP.has(t));
+}
+/** Rank doc entries by overlap of query terms with title (weighted), section, description and url. */
+export async function searchDocs(query, limit = 6) {
+    const entries = await loadIndex();
+    const terms = tokenize(query);
+    if (!terms.length)
+        return entries.slice(0, limit);
+    const scored = entries.map((e) => {
+        const title = e.title.toLowerCase();
+        const hay = `${e.section} ${e.description} ${e.url}`.toLowerCase();
+        let score = 0;
+        for (const t of terms) {
+            if (title.includes(t))
+                score += 3;
+            if (hay.includes(t))
+                score += 1;
+        }
+        return { e, score };
+    });
+    return scored
+        .filter((x) => x.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit)
+        .map((x) => x.e);
+}
+/** Resolve a page URL/path to its markdown-mirror URL (`<page-url>index.md`). */
+export function mirrorUrl(pageUrl) {
+    const url = assertImqueueUrl(pageUrl);
+    let p = url.pathname;
+    if (p.endsWith("index.md"))
+        return url.href;
+    if (p.endsWith(".md"))
+        return url.href;
+    if (!p.endsWith("/"))
+        p += "/";
+    return `${SITE}${p}index.md`;
+}
+/** Fetch the full markdown of a doc page by its page URL or path. */
+export async function getDoc(pageUrl) {
+    const mUrl = mirrorUrl(pageUrl);
+    const res = await fetch(mUrl);
+    if (!res.ok)
+        throw new Error(`Failed to fetch ${mUrl} (HTTP ${res.status}). Use search_docs to find a valid page URL.`);
+    return { url: mUrl, markdown: await res.text() };
+}
+//# sourceMappingURL=docs.js.map

package/dist/docs.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+// @imqueue MCP server — exposes @imqueue docs search and service/client
+// scaffolding to AI coding agents (Claude Code, Cursor, …) over stdio.
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { searchDocs, getDoc } from "./docs.js";
+import { renderPackages } from "./packages.js";
+import { scaffoldService, scaffoldClient } from "./scaffold.js";
+const text = (t) => ({ content: [{ type: "text", text: t }] });
+const fail = (e) => ({
+    content: [{ type: "text", text: `Error: ${e instanceof Error ? e.message : String(e)}` }],
+    isError: true,
+});
+const methodSchema = z
+    .object({
+    name: z.string().describe("Method name"),
+    description: z.string().optional().describe("What the method does"),
+    params: z
+        .array(z.object({
+        name: z.string(),
+        type: z.string().describe("TypeScript type, e.g. 'string' or 'number[]'"),
+        description: z.string().optional(),
+    }))
+        .optional(),
+    returns: z.string().optional().describe("TypeScript return type WITHOUT Promise<> — e.g. 'User' or 'string'"),
+})
+    .strict();
+const server = new McpServer({ name: "imqueue", version: "0.1.0" });
+server.registerTool("search_docs", {
+    title: "Search @imqueue documentation",
+    description: "Search the official @imqueue docs (guides, tutorial, CLI manual, API reference, articles) and return the most relevant pages with their URLs. Use this first when asked how to do something in @imqueue, then get_doc to read a page in full.",
+    inputSchema: {
+        query: z.string().describe("What you want to find, e.g. 'expose a service method' or 'delayed jobs'"),
+        limit: z.number().int().min(1).max(20).optional().describe("Max results (default 6)"),
+    },
+}, async ({ query, limit }) => {
+    try {
+        const hits = await searchDocs(query, limit ?? 6);
+        if (!hits.length)
+            return text(`No matches for "${query}". Try broader terms or call list_packages.`);
+        const body = hits
+            .map((h) => `### ${h.title}  _(${h.section})_\n${h.description}\n${h.url}`)
+            .join("\n\n");
+        return text(`${hits.length} result(s) for "${query}":\n\n${body}\n\nRead any page in full with get_doc(url).`);
+    }
+    catch (e) {
+        return fail(e);
+    }
+});
+server.registerTool("get_doc", {
+    title: "Read an @imqueue doc page",
+    description: "Fetch the full markdown of an @imqueue documentation page by its URL (as returned by search_docs). Returns plain markdown suitable for reading and quoting.",
+    inputSchema: {
+        url: z.string().describe("An imqueue.org page URL, e.g. https://imqueue.org/get-started/"),
+    },
+}, async ({ url }) => {
+    try {
+        const doc = await getDoc(url);
+        return text(`Source: ${doc.url}\n\n${doc.markdown}`);
+    }
+    catch (e) {
+        return fail(e);
+    }
+});
+server.registerTool("list_packages", {
+    title: "List @imqueue packages",
+    description: "Return the main @imqueue packages with a one-line summary and install command, so you can pick the right one.",
+    inputSchema: {},
+}, async () => {
+    try {
+        return text(renderPackages());
+    }
+    catch (e) {
+        return fail(e);
+    }
+});
+server.registerTool("scaffold_service", {
+    title: "Scaffold an @imqueue service",
+    description: "Generate an idiomatic @imqueue/rpc service (an IMQService subclass with @expose()d, JSDoc-typed methods) plus a bootstrap that starts it. Provide the methods you want, or omit them for a starter template.",
+    inputSchema: {
+        name: z.string().describe("Service name, e.g. 'user' or 'UserService'"),
+        methods: z.array(methodSchema).optional().describe("Methods to expose"),
+    },
+}, async ({ name, methods }) => {
+    try {
+        return text(scaffoldService(name, methods));
+    }
+    catch (e) {
+        return fail(e);
+    }
+});
+server.registerTool("scaffold_client", {
+    title: "Scaffold an @imqueue typed client",
+    description: "Show how to generate and use the fully-typed client for an @imqueue service. @imqueue generates the real client from a running service (via `imq client generate`), so this returns that command plus an illustrative usage snippet.",
+    inputSchema: {
+        service: z.string().describe("The service to call, e.g. 'user' or 'UserService'"),
+        methods: z.array(methodSchema).optional().describe("Known methods (used to shape the example call)"),
+    },
+}, async ({ service, methods }) => {
+    try {
+        return text(scaffoldClient(service, methods));
+    }
+    catch (e) {
+        return fail(e);
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // stderr is safe for logs; stdout is the JSON-RPC channel.
+    console.error("@imqueue MCP server running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/packages.d.ts

@@ -0,0 +1,7 @@
+export interface PkgInfo {
+    name: string;
+    install: string;
+    summary: string;
+}
+export declare const PACKAGES: PkgInfo[];
+export declare function renderPackages(): string;

package/dist/packages.js

@@ -0,0 +1,18 @@
+// Static catalog of the main @imqueue packages, so an agent can pick the right
+// one before scaffolding. Kept deliberately short — the full ecosystem lives on
+// imqueue.org and is reachable via search_docs.
+export const PACKAGES = [
+    { name: "@imqueue/rpc", install: "npm i @imqueue/rpc", summary: "Type-safe RPC over a message queue — decorators, services and generated clients. The package you build services with." },
+    { name: "@imqueue/core", install: "npm i @imqueue/core", summary: "The Redis-backed messaging-queue engine shared by the framework (usually a transitive dependency of rpc)." },
+    { name: "@imqueue/cli", install: "npm i -g @imqueue/cli", summary: "The `imq` CLI: scaffolds services, wires VCS/CI/registry providers, generates typed clients and runs a local fleet." },
+    { name: "@imqueue/job", install: "npm i @imqueue/job", summary: "Simple, safe-by-default Redis job queue — delayed/scheduled jobs, guaranteed processing, retries." },
+    { name: "@imqueue/pg-pubsub", install: "npm i @imqueue/pg-pubsub", summary: "Reliable PostgreSQL LISTEN/NOTIFY with inter-process lock support." },
+    { name: "@imqueue/pg-cache", install: "npm i @imqueue/pg-cache", summary: "PostgreSQL-managed cache on Redis for @imqueue service methods." },
+    { name: "@imqueue/async-logger", install: "npm i @imqueue/async-logger", summary: "Configurable async logger over winston for @imqueue services." },
+    { name: "@imqueue/http-protect", install: "npm i @imqueue/http-protect", summary: "HTTP DDoS-protection middleware." },
+];
+export function renderPackages() {
+    const lines = PACKAGES.map((p) => `- **${p.name}** — ${p.summary}\n  \`${p.install}\``);
+    return `# @imqueue packages\n\n${lines.join("\n")}\n\nFull ecosystem & docs: https://imqueue.org`;
+}
+//# sourceMappingURL=packages.js.map

package/dist/packages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages.js","sourceRoot":"","sources":["../src/packages.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gFAAgF;AAChF,gDAAgD;AAQhD,MAAM,CAAC,MAAM,QAAQ,GAAc;IACjC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,uHAAuH,EAAE;IACzL,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,2GAA2G,EAAE;IAC/K,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,uBAAuB,EAAE,OAAO,EAAE,qHAAqH,EAAE;IAC1L,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,mGAAmG,EAAE;IACrK,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,0BAA0B,EAAE,OAAO,EAAE,oEAAoE,EAAE;IAClJ,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,yBAAyB,EAAE,OAAO,EAAE,iEAAiE,EAAE;IAC7I,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,6BAA6B,EAAE,OAAO,EAAE,+DAA+D,EAAE;IACnJ,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,6BAA6B,EAAE,OAAO,EAAE,kCAAkC,EAAE;CACvH,CAAC;AAEF,MAAM,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;IACxF,OAAO,0BAA0B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gDAAgD,CAAC;AACpG,CAAC"}

package/dist/scaffold.d.ts

@@ -0,0 +1,14 @@
+export interface MethodSpec {
+    name: string;
+    description?: string;
+    params?: {
+        name: string;
+        type: string;
+        description?: string;
+    }[];
+    returns?: string;
+}
+/** Generate an @imqueue/rpc service class + a bootstrap that starts it. */
+export declare function scaffoldService(name: string, methods?: MethodSpec[]): string;
+/** Generate a typed-client usage snippet for a service. */
+export declare function scaffoldClient(service: string, methods?: MethodSpec[]): string;

package/dist/scaffold.js

@@ -0,0 +1,106 @@
+// Code scaffolding for @imqueue — mirrors what `imq service create` /
+// `imq client generate` produce, but as inline templates an agent can drop into
+// a project. @imqueue is decorator-driven and JSDoc is the source of truth for
+// types, so the generated code documents each method with JSDoc.
+function pascal(s) {
+    return s
+        .replace(/[^a-zA-Z0-9]+/g, " ")
+        .trim()
+        .split(/\s+/)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join("");
+}
+const DEFAULT_METHODS = [
+    {
+        name: "hello",
+        description: "Example method — replace with your own.",
+        params: [{ name: "name", type: "string", description: "Who to greet" }],
+        returns: "string",
+    },
+];
+function renderMethod(m) {
+    const params = m.params ?? [];
+    const ret = m.returns ?? "void";
+    const sig = params.map((p) => `${p.name}: ${p.type}`).join(", ");
+    const jsdoc = [
+        "    /**",
+        `     * ${m.description ?? m.name}`,
+        ...params.map((p) => `     * @param ${p.name} - ${p.description ?? p.type}`),
+        `     * @return {Promise<${ret}>}`,
+        "     */",
+    ].join("\n");
+    const body = ret === "void"
+        ? "        // TODO: implement"
+        : `        // TODO: implement\n        throw new Error('${m.name}() not implemented');`;
+    return `${jsdoc}\n    @expose()\n    public async ${m.name}(${sig}): Promise<${ret}> {\n${body}\n    }`;
+}
+/** Generate an @imqueue/rpc service class + a bootstrap that starts it. */
+export function scaffoldService(name, methods) {
+    const cls = pascal(name).endsWith("Service") ? pascal(name) : `${pascal(name)}Service`;
+    const list = methods && methods.length ? methods : DEFAULT_METHODS;
+    const body = list.map(renderMethod).join("\n\n");
+    const service = `import { IMQService, expose } from '@imqueue/rpc';
+
+export class ${cls} extends IMQService {
+${body}
+}
+`;
+    const bootstrap = `import { ${cls} } from './${cls}';
+
+// Start the service so other services can call its @expose()d methods.
+(async () => {
+    const service = new ${cls}({ name: '${cls}' });
+    await service.start();
+    console.log('${cls} is up');
+})();
+`;
+    return [
+        `Install: \`npm i @imqueue/rpc\` (needs a running Redis).`,
+        "",
+        `**${cls}.ts**`,
+        "```typescript",
+        service.trimEnd(),
+        "```",
+        "",
+        `**index.ts** (bootstrap)`,
+        "```typescript",
+        bootstrap.trimEnd(),
+        "```",
+        "",
+        `Tip: scaffold a full, provider-wired project (VCS/CI/Docker) with the CLI instead: \`imq service create ${name}\`.`,
+    ].join("\n");
+}
+/** Generate a typed-client usage snippet for a service. */
+export function scaffoldClient(service, methods) {
+    const cls = pascal(service).endsWith("Service") ? pascal(service) : `${pascal(service)}Service`;
+    const clientCls = cls.replace(/Service$/, "Client");
+    const sample = (methods && methods[0]) || DEFAULT_METHODS[0];
+    const args = (sample.params ?? []).map((p) => `/* ${p.name}: ${p.type} */`).join(", ");
+    const usage = `import { ${clientCls} } from './clients/${clientCls}';
+
+(async () => {
+    const client = new ${clientCls}();
+    await client.start();
+
+    // Fully-typed remote call — signature comes from ${cls}:
+    const result = await client.${sample.name}(${args});
+    console.log(result);
+})();
+`;
+    return [
+        `@imqueue generates the **real**, fully-typed client from a **running** service, so its types can never drift:`,
+        "",
+        "```bash",
+        `# with ${cls} running:`,
+        `imq client generate ${cls.replace(/Service$/, "")}`,
+        "```",
+        "",
+        `That emits \`./clients/${clientCls}\`. Use it like:`,
+        "```typescript",
+        usage.trimEnd(),
+        "```",
+        "",
+        `The snippet above is illustrative — prefer the generated client so method signatures stay in sync with the service.`,
+    ].join("\n");
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@imqueue/mcp",
+  "version": "1.0.0",
+  "description": "Model Context Protocol server for @imqueue — lets AI coding agents search the docs and scaffold typed services & clients.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "imqueue",
+    "ai",
+    "coding-assistant",
+    "cursor",
+    "claude",
+    "rpc",
+    "microservices",
+    "nodejs",
+    "typescript"
+  ],
+  "homepage": "https://imqueue.org",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/imqueue/mcp.git"
+  },
+  "license": "GPL-3.0",
+  "author": "imqueue.com <support@imqueue.com>",
+  "type": "module",
+  "bin": {
+    "imqueue-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "SPEC.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "smoke": "node scripts/smoke.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  }
+}