@doconda/mcp 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# @doconda/mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+MCP server for [Doconda](https://doconda.com): create, review and edit **Word, PowerPoint, Excel and PDF** documents from Claude Code, Claude Desktop, OpenAI Codex, Cursor or any MCP client.
+
+## Claude Desktop, Cursor and other clients
+
+```json
+{
+  "mcpServers": {
+    "doconda": {
+      "command": "npx",
+      "args": ["-y", "@doconda/mcp"],
+      "env": { "DOCONDA_API_KEY": "ak_eu_…" }
+    }
+  }
+}
+```
+
+## Claude Code
+
+```bash
+claude mcp add --transport stdio --env DOCONDA_API_KEY=ak_eu_… doconda -- npx -y @doconda/mcp
+```
+
+## OpenAI Codex (`~/.codex/config.toml`)
+
+```toml
+[mcp_servers.doconda]
+command = "npx"
+args = ["-y", "@doconda/mcp"]
+env = { DOCONDA_API_KEY = "ak_eu_…" }
+```
+
+Then ask: *"make an Excel with this project's costs"* or *"review this contract.docx before I send it"*.
+
+There is also a remote server, with no install: `https://api.eu.doconda.com/mcp` (Streamable HTTP, header `Authorization: Bearer ak_eu_…`).
+
+Tools: `create_document`, `upload_file`, `review_document`, `edit_document`, `list_documents`, `get_document`, `get_report`, `read_artifact_data`.
+
+Docs: https://docs.doconda.com/en/agents/mcp · Get an API key: https://doconda.com

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/cli.mjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { t as createServer } from "./src-BaSOMaOO.mjs";
+import { Doconda } from "@doconda/sdk";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+//#region src/cli.ts
+await createServer(new Doconda(), { localFiles: true }).connect(new StdioServerTransport());
+//#endregion
+export {};

package/dist/http.d.mts

@@ -0,0 +1,5 @@
+import { Doconda } from "@doconda/sdk";
+import { IncomingMessage, ServerResponse } from "node:http";
+//#region src/http.d.ts
+export declare function handleMcpRequest(doconda: Doconda, req: IncomingMessage, res: ServerResponse, body: unknown): Promise<void>;
+//#endregion

package/dist/http.mjs

@@ -0,0 +1,18 @@
+import { t as createServer } from "./src-BaSOMaOO.mjs";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+//#region src/http.ts
+async function handleMcpRequest(doconda, req, res, body) {
+	const server = createServer(doconda);
+	const transport = new StreamableHTTPServerTransport({
+		sessionIdGenerator: void 0,
+		enableJsonResponse: true
+	});
+	res.on("close", () => {
+		transport.close();
+		server.close();
+	});
+	await server.connect(transport);
+	await transport.handleRequest(req, res, body);
+}
+//#endregion
+export { handleMcpRequest };

package/dist/index.d.mts

@@ -0,0 +1,5 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { Doconda, ToolOptions } from "@doconda/sdk";
+//#region src/index.d.ts
+export declare function createServer(doconda: Doconda, options?: ToolOptions): Server;
+//#endregion

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { t as createServer } from "./src-BaSOMaOO.mjs";
+export { createServer };

package/dist/src-BaSOMaOO.mjs

@@ -0,0 +1,55 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { DocondaError } from "@doconda/sdk";
+//#region src/index.ts
+function createServer(doconda, options = {}) {
+	const tools = doconda.tools(options);
+	const server = new Server({
+		name: "doconda",
+		version: "0.1.0"
+	}, {
+		capabilities: { tools: {} },
+		instructions: "Doconda creates, reviews and edits documents (Word, PDF, PowerPoint, Excel) and artifacts (web pages with shared data). Share the links it returns with the user; they expire, so call get_document for fresh ones."
+	});
+	server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: tools.map(({ name, description, inputSchema }) => ({
+		name,
+		description,
+		inputSchema
+	})) }));
+	server.setRequestHandler(CallToolRequestSchema, async (request) => {
+		const tool = tools.find((t) => t.name === request.params.name);
+		if (!tool) return {
+			isError: true,
+			content: [{
+				type: "text",
+				text: `Unknown tool ${request.params.name}.`
+			}]
+		};
+		try {
+			const result = await tool.run(request.params.arguments ?? {});
+			return { content: [{
+				type: "text",
+				text: JSON.stringify(result, null, 2)
+			}] };
+		} catch (err) {
+			const e = err instanceof DocondaError ? {
+				error: err.code,
+				message: err.message,
+				fields: err.errors
+			} : {
+				error: "failed",
+				message: String(err?.message ?? err)
+			};
+			return {
+				isError: true,
+				content: [{
+					type: "text",
+					text: JSON.stringify(e)
+				}]
+			};
+		}
+	});
+	return server;
+}
+//#endregion
+export { createServer as t };

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "@doconda/mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Doconda MCP server: create, review and edit Word, PowerPoint, Excel and PDF documents from Claude Code, Codex, Cursor and any MCP client.",
+  "keywords": [
+    "docx",
+    "pptx",
+    "xlsx",
+    "pdf",
+    "word",
+    "powerpoint",
+    "excel",
+    "document-generation",
+    "ai-agents",
+    "llm",
+    "tools",
+    "ai-sdk",
+    "openai",
+    "anthropic",
+    "bedrock",
+    "vertex-ai",
+    "mcp",
+    "model-context-protocol",
+    "claude-code",
+    "cursor",
+    "codex"
+  ],
+  "homepage": "https://doconda.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/B-C-Software/doconda.git",
+    "directory": "packages/mcp"
+  },
+  "type": "module",
+  "bin": {
+    "doconda-mcp": "./dist/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./http": {
+      "types": "./dist/http.d.mts",
+      "default": "./dist/http.mjs"
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.31.0",
+    "zod": "^4.5.4",
+    "@doconda/sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.3",
+    "typescript": "~6.0.3"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "node --test 'src/**/*.test.ts'",
+    "typecheck": "tsc --noEmit",
+    "build": "tsdown"
+  }
 }