@scottsus/mdreview-mcp 0.1.0

package/dist/api-client.d.ts

@@ -0,0 +1,58 @@
+interface CreateReviewResponse {
+    id: string;
+    slug: string;
+    url: string;
+    status: string;
+    createdAt: string;
+}
+interface ReviewResponse {
+    id: string;
+    slug: string;
+    url: string;
+    content: string;
+    title: string | null;
+    status: string;
+    decisionMessage: string | null;
+    decidedAt: string | null;
+    threads: ThreadResponse[];
+    createdAt: string;
+    updatedAt: string;
+}
+interface ThreadResponse {
+    id: string;
+    startOffset: number;
+    endOffset: number;
+    selectedText: string;
+    resolved: boolean;
+    comments: CommentResponse[];
+}
+interface CommentResponse {
+    id: string;
+    body: string;
+    authorType: string;
+    authorName: string | null;
+    createdAt: string;
+}
+interface WaitResponse {
+    id: string;
+    status: string;
+    decisionMessage: string | null;
+    decidedAt: string | null;
+    threads: ThreadResponse[];
+    summary: {
+        totalThreads: number;
+        resolvedThreads: number;
+        unresolvedThreads: number;
+        totalComments: number;
+    };
+}
+export declare class ApiClient {
+    private baseUrl;
+    constructor(baseUrl?: string);
+    createReview(content: string, title?: string): Promise<CreateReviewResponse>;
+    getReview(reviewId: string): Promise<ReviewResponse>;
+    waitForReview(reviewId: string, timeoutSeconds?: number): Promise<WaitResponse>;
+    addComment(threadId: string, body: string): Promise<CommentResponse>;
+}
+export {};
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAEA,UAAU,oBAAoB;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,CAAC,EAAE,MAAM;IAItB,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC;IAmB1B,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAWpD,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,cAAc,SAAM,GACnB,OAAO,CAAC,YAAY,CAAC;IAalB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAqB3E"}

package/dist/api-client.js

@@ -0,0 +1,55 @@
+const BASE_URL = process.env.MDREVIEW_BASE_URL || "https://mdreview.vercel.app";
+export class ApiClient {
+    baseUrl;
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl || BASE_URL;
+    }
+    async createReview(content, title) {
+        const response = await fetch(`${this.baseUrl}/api/reviews`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                content,
+                title,
+                source: "agent",
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.json();
+            throw new Error(error.message || "Failed to create review");
+        }
+        return response.json();
+    }
+    async getReview(reviewId) {
+        const response = await fetch(`${this.baseUrl}/api/reviews/${reviewId}`);
+        if (!response.ok) {
+            const error = await response.json();
+            throw new Error(error.message || "Failed to get review");
+        }
+        return response.json();
+    }
+    async waitForReview(reviewId, timeoutSeconds = 300) {
+        const response = await fetch(`${this.baseUrl}/api/reviews/${reviewId}/wait?timeout=${timeoutSeconds}`);
+        if (!response.ok) {
+            const error = await response.json();
+            throw new Error(error.message || "Failed to wait for review");
+        }
+        return response.json();
+    }
+    async addComment(threadId, body) {
+        const response = await fetch(`${this.baseUrl}/api/threads/${threadId}/replies`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                body,
+                authorType: "agent",
+                authorName: "AI Agent",
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.json();
+            throw new Error(error.message || "Failed to add comment");
+        }
+        return response.json();
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { ApiClient } from "./api-client.js";
+const server = new McpServer({
+    name: "mdreview",
+    version: "0.1.0",
+});
+const apiClient = new ApiClient(process.env.MDREVIEW_BASE_URL);
+// Tool: request_review
+server.registerTool("request_review", {
+    title: "Request Review",
+    description: "Create a markdown document review and get a shareable URL. Share this URL with the reviewer and they can add inline comments and approve/reject the document.",
+    inputSchema: {
+        content: z.string().describe("The markdown content to review"),
+        title: z.string().optional().describe("Optional title for the review"),
+    },
+}, async ({ content, title }) => {
+    const result = await apiClient.createReview(content, title);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Review created successfully!\n\nReview URL: ${result.url}\n\nShare this URL with your reviewer. They can:\n- Add inline comments by selecting text\n- Approve, reject, or request changes\n\nUse 'wait_for_review' with reviewId "${result.id}" to wait for the review to complete.`,
+            },
+        ],
+        structuredContent: {
+            reviewId: result.id,
+            url: result.url,
+            status: result.status,
+        },
+    };
+});
+// Tool: wait_for_review
+server.registerTool("wait_for_review", {
+    title: "Wait for Review",
+    description: "Wait for a review to be completed (approved, rejected, or changes requested). This will block until the reviewer makes a decision or the timeout is reached.",
+    inputSchema: {
+        reviewId: z.string().describe("The review ID to wait for"),
+        timeoutSeconds: z
+            .number()
+            .min(1)
+            .max(300)
+            .default(300)
+            .describe("Maximum time to wait in seconds (default: 300)"),
+    },
+}, async ({ reviewId, timeoutSeconds }) => {
+    const result = await apiClient.waitForReview(reviewId, timeoutSeconds);
+    if (result.status === "pending") {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Review is still pending after ${timeoutSeconds} seconds. You can call wait_for_review again to continue waiting.`,
+                },
+            ],
+            structuredContent: { status: "pending", timedOut: true },
+        };
+    }
+    const commentsText = result.threads
+        .map((thread) => {
+        const comments = thread.comments
+            .map((c) => `  - ${c.authorType}: ${c.body}`)
+            .join("\n");
+        return `[${thread.resolved ? "RESOLVED" : "UNRESOLVED"}] "${thread.selectedText}"\n${comments}`;
+    })
+        .join("\n\n");
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Review completed!\n\nStatus: ${result.status.toUpperCase()}\nMessage: ${result.decisionMessage || "(none)"}\n\nSummary:\n- Total threads: ${result.summary.totalThreads}\n- Resolved: ${result.summary.resolvedThreads}\n- Unresolved: ${result.summary.unresolvedThreads}\n- Total comments: ${result.summary.totalComments}\n\n${commentsText ? `Comments:\n${commentsText}` : "No comments."}`,
+            },
+        ],
+        structuredContent: { ...result },
+    };
+});
+// Tool: get_review_status
+server.registerTool("get_review_status", {
+    title: "Get Review Status",
+    description: "Get the current status of a review without waiting. Use this to check if a review has been completed.",
+    inputSchema: {
+        reviewId: z.string().describe("The review ID to check"),
+    },
+}, async ({ reviewId }) => {
+    const result = await apiClient.getReview(reviewId);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Review Status: ${result.status.toUpperCase()}\nTitle: ${result.title || "(untitled)"}\nThreads: ${result.threads.length}\nURL: ${result.url}`,
+            },
+        ],
+        structuredContent: {
+            status: result.status,
+            threadCount: result.threads.length,
+            commentCount: result.threads.reduce((sum, t) => sum + t.comments.length, 0),
+        },
+    };
+});
+// Tool: add_comment
+server.registerTool("add_comment", {
+    title: "Add Comment",
+    description: "Add a reply to an existing comment thread. Use this to respond to reviewer feedback.",
+    inputSchema: {
+        threadId: z.string().describe("The thread ID to reply to"),
+        body: z.string().describe("The comment text"),
+    },
+}, async ({ threadId, body }) => {
+    const result = await apiClient.addComment(threadId, body);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Comment added successfully!\n\nThread: ${result.id}\nComment: ${result.body}`,
+            },
+        ],
+        structuredContent: {
+            commentId: result.id,
+            createdAt: result.createdAt,
+        },
+    };
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("MDReview MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@scottsus/mdreview-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for MDReview - markdown document review tool",
+  "type": "module",
+  "bin": {
+    "mdreview-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@mdreview/typescript-config": "workspace:*",
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0"
+  },
+  "keywords": [
+    "mcp",
+    "markdown",
+    "review",
+    "ai",
+    "claude",
+    "cursor",
+    "opencode"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/scottsus/mdreview"
+  }
+}