foundationworks-mcp 0.1.0

package/README.md

@@ -0,0 +1,138 @@
+# foundationworks-mcp
+
+Connect your AI coding agent to your product specs.
+
+> Design in Foundation → Connect via MCP → Vibe code your product
+
+## What is this?
+
+MCP server that gives Claude, Cursor, Windsurf, and other AI agents access to your PRDs and TDDs in [Foundation](https://foundationworks.io).
+
+**Foundation** is a design workspace for creating product requirements (PRDs) and technical design documents (TDDs). This MCP server lets your AI coding agent read those specs directly, so it builds what you actually designed.
+
+## Quick Start
+
+### 1. Get your token
+
+**Existing user:** Settings → Agent Tokens → Create Token
+
+**New here?** [Sign up at foundationworks.io](https://foundationworks.io)
+
+### 2. Configure your AI tool
+
+**Claude Desktop** (`~/.claude/config.json`):
+
+```json
+{
+  "mcpServers": {
+    "foundation": {
+      "command": "npx",
+      "args": ["-y", "foundationworks-mcp"],
+      "env": {
+        "FOUNDATION_TOKEN": "mcp_your_token_here"
+      }
+    }
+  }
+}
+```
+
+**Claude Code** (`~/.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "foundation": {
+      "command": "npx",
+      "args": ["-y", "foundationworks-mcp"],
+      "env": {
+        "FOUNDATION_TOKEN": "mcp_your_token_here"
+      }
+    }
+  }
+}
+```
+
+**Cursor** (MCP settings):
+
+```json
+{
+  "foundation": {
+    "command": "npx",
+    "args": ["-y", "foundationworks-mcp"],
+    "env": {
+      "FOUNDATION_TOKEN": "mcp_your_token_here"
+    }
+  }
+}
+```
+
+**Zed** (`~/.config/zed/settings.json`):
+
+```json
+{
+  "context_servers": {
+    "foundation": {
+      "command": "npx",
+      "args": ["-y", "foundationworks-mcp"],
+      "env": {
+        "FOUNDATION_TOKEN": "mcp_your_token_here"
+      }
+    }
+  }
+}
+```
+
+### 3. Start building
+
+Ask your AI: *"Check my PRD for the authentication requirements"*
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `foundation_menu` | List available sections with summaries, keywords, and token counts |
+| `foundation_fetch` | Get full content for specific sections |
+| `foundation_search` | Semantic search across your specs |
+| `foundation_comment` | Post deviation reports or suggestions back to your docs |
+
+## Example Workflow
+
+```
+You: "What does the PRD say about user authentication?"
+
+AI: [calls foundation_menu to see available sections]
+AI: [calls foundation_search with "user authentication"]
+AI: [calls foundation_fetch to get the relevant sections]
+AI: "Based on your PRD, authentication should use..."
+```
+
+When implementation differs from spec:
+
+```
+AI: [calls foundation_comment with a deviation_report]
+AI: "I've noted that we're using JWT instead of sessions as specified.
+     Posted a deviation report to the PRD for your team to review."
+```
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `FOUNDATION_TOKEN` | Yes | — | Your agent token from Foundation |
+| `FOUNDATION_API_URL` | No | `https://app.foundationworks.io/api/mcp` | API base URL |
+
+## Why use this?
+
+**Without Foundation MCP:**
+- Copy-paste specs into chat
+- AI forgets context between sessions
+- No record of what the AI actually built vs. what was designed
+
+**With Foundation MCP:**
+- AI reads your specs directly
+- Specs stay up-to-date in one place
+- Deviation reports track where implementation differs from design
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Foundation MCP Server
+ *
+ * Provides MCP (Model Context Protocol) access to Foundation PRD/TDD documents.
+ * Enables AI coding agents to intelligently select and fetch relevant context.
+ *
+ * Environment variables:
+ *   FOUNDATION_TOKEN - Required: Your Foundation agent token (mcp_xxx)
+ *   FOUNDATION_API_URL - Optional: API base URL (default: https://app.foundationworks.io/api/mcp)
+ */
+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":";AACA;;;;;;;;;GASG"}

package/dist/index.js

@@ -0,0 +1,316 @@
+#!/usr/bin/env node
+/**
+ * Foundation MCP Server
+ *
+ * Provides MCP (Model Context Protocol) access to Foundation PRD/TDD documents.
+ * Enables AI coding agents to intelligently select and fetch relevant context.
+ *
+ * Environment variables:
+ *   FOUNDATION_TOKEN - Required: Your Foundation agent token (mcp_xxx)
+ *   FOUNDATION_API_URL - Optional: API base URL (default: https://app.foundationworks.io/api/mcp)
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+// Configuration
+const FOUNDATION_TOKEN = process.env.FOUNDATION_TOKEN;
+const FOUNDATION_API_URL = process.env.FOUNDATION_API_URL || "https://app.foundationworks.io/api/mcp";
+if (!FOUNDATION_TOKEN) {
+    console.error("Error: FOUNDATION_TOKEN environment variable is required");
+    console.error("Get your token from Foundation Settings → Agent Tokens");
+    process.exit(1);
+}
+// Tool definitions
+const tools = [
+    {
+        name: "foundation_menu",
+        description: `Get a menu of all available PRD/TDD sections with summaries, keywords, and token counts.
+Use this first to understand what context is available and decide which sections to fetch.
+Returns section metadata without full content to minimize token usage.`,
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "foundation_fetch",
+        description: `Fetch full content for specific document sections.
+Use after foundation_menu to retrieve only the sections you need.
+Supports both PRD and TDD sections with optional prefix (e.g., 'tdd.api_design').`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                sections: {
+                    type: "string",
+                    description: "Comma-separated section keys to fetch (e.g., 'epics,background' or 'prd.epics,tdd.api_design')",
+                },
+            },
+            required: ["sections"],
+        },
+    },
+    {
+        name: "foundation_search",
+        description: `Search across PRD/TDD sections using combined keyword and semantic matching.
+Returns relevant sections ranked by relevance score (keyword 60% + semantic 40%).
+Use when you need to find specific information but don't know which section contains it.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query (e.g., 'authentication flow' or 'database schema')",
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum number of results (default: 10, max: 50)",
+                },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "foundation_comment",
+        description: `Post a comment on a document section. Use for:
+- deviation_report: When implementation differs from spec
+- suggestion: Proposing improvements to the document
+- discussion: General questions or notes
+
+Requires read access to the document type.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                document_type: {
+                    type: "string",
+                    enum: ["prd", "tdd"],
+                    description: "Type of document to comment on",
+                },
+                document_id: {
+                    type: "string",
+                    description: "Document ID (from context menu response)",
+                },
+                section_key: {
+                    type: "string",
+                    description: "Section key to attach comment to (e.g., 'epics', 'api_design')",
+                },
+                content: {
+                    type: "string",
+                    description: "Comment content (max 10000 characters)",
+                },
+                comment_type: {
+                    type: "string",
+                    enum: ["deviation_report", "suggestion", "discussion"],
+                    description: "Type of comment (default: deviation_report)",
+                },
+            },
+            required: ["document_type", "document_id", "section_key", "content"],
+        },
+    },
+];
+// API client
+async function apiRequest(endpoint, options = {}) {
+    const url = `${FOUNDATION_API_URL}${endpoint}`;
+    try {
+        const response = await fetch(url, {
+            ...options,
+            headers: {
+                Authorization: `Bearer ${FOUNDATION_TOKEN}`,
+                "Content-Type": "application/json",
+                ...options.headers,
+            },
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            const errorMessage = data.detail?.message || data.detail || data.error || "Unknown error";
+            return { success: false, error: `${response.status}: ${errorMessage}` };
+        }
+        return { success: true, data };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Network error";
+        return { success: false, error: message };
+    }
+}
+// Tool handlers
+async function handleGetContextMenu() {
+    const result = await apiRequest("/context-menu");
+    if (!result.success) {
+        return `Error fetching context menu: ${result.error}`;
+    }
+    const data = result.data;
+    // Format for easy reading
+    let output = "# Available Context\n\n";
+    if (data.data.prd) {
+        output += `## PRD: ${data.data.prd.title}\n`;
+        output += `ID: ${data.data.prd.id}\n\n`;
+        for (const section of data.data.prd.sections) {
+            output += `### ${section.title} (${section.key})\n`;
+            output += `- Tokens: ${section.token_count}\n`;
+            output += `- Keywords: ${section.keywords.join(", ") || "none"}\n`;
+            if (section.summary) {
+                output += `- Summary: ${section.summary}\n`;
+            }
+            output += "\n";
+        }
+    }
+    if (data.data.tdd) {
+        output += `## TDD: ${data.data.tdd.title}\n`;
+        output += `ID: ${data.data.tdd.id}\n\n`;
+        for (const section of data.data.tdd.sections) {
+            output += `### ${section.title} (${section.key})\n`;
+            output += `- Tokens: ${section.token_count}\n`;
+            output += `- Keywords: ${section.keywords.join(", ") || "none"}\n`;
+            if (section.summary) {
+                output += `- Summary: ${section.summary}\n`;
+            }
+            output += "\n";
+        }
+    }
+    output += `---\nTotal tokens if fetching all: ${data.data.total_tokens}\n`;
+    output += `\nUse foundation_fetch with specific section keys to fetch full content.`;
+    return output;
+}
+async function handleGetContext(sections) {
+    const result = await apiRequest(`/context?sections=${encodeURIComponent(sections)}`);
+    if (!result.success) {
+        return `Error fetching context: ${result.error}`;
+    }
+    const data = result.data;
+    let output = "# Requested Context\n\n";
+    if (data.data.prd) {
+        output += "## PRD Sections\n\n";
+        for (const [key, section] of Object.entries(data.data.prd)) {
+            output += `### ${section.title} (${key})\n`;
+            output += "```json\n";
+            output += JSON.stringify(section.content, null, 2);
+            output += "\n```\n\n";
+        }
+    }
+    if (data.data.tdd) {
+        output += "## TDD Sections\n\n";
+        for (const [key, section] of Object.entries(data.data.tdd)) {
+            output += `### ${section.title} (${key})\n`;
+            output += "```json\n";
+            output += JSON.stringify(section.content, null, 2);
+            output += "\n```\n\n";
+        }
+    }
+    output += `---\nTotal tokens: ${data.data.total_tokens}`;
+    return output;
+}
+async function handleSearchContext(query, limit) {
+    const params = new URLSearchParams({ q: query });
+    if (limit)
+        params.set("limit", String(limit));
+    const result = await apiRequest(`/search?${params}`);
+    if (!result.success) {
+        return `Error searching: ${result.error}`;
+    }
+    const data = result.data;
+    let output = `# Search Results for "${data.data.query}"\n\n`;
+    output += `Found ${data.data.total_matches} matching sections:\n\n`;
+    for (const match of data.data.matches) {
+        output += `## ${match.section_title} (${match.document_type}.${match.section_key})\n`;
+        output += `- Relevance: ${match.relevance} (${match.relevance_score})\n`;
+        output += `- Matched keywords: ${match.matched_keywords.join(", ") || "semantic match"}\n`;
+        output += `- Tokens: ${match.token_count}\n`;
+        if (match.summary) {
+            output += `- Summary: ${match.summary}\n`;
+        }
+        output += "\n";
+    }
+    output += `\nUse foundation_fetch with section keys to fetch full content.`;
+    return output;
+}
+async function handlePostComment(documentType, documentId, sectionKey, content, commentType = "deviation_report") {
+    const result = await apiRequest("/comments", {
+        method: "POST",
+        body: JSON.stringify({
+            document_type: documentType,
+            document_id: documentId,
+            section_key: sectionKey,
+            content,
+            comment_type: commentType,
+        }),
+    });
+    if (!result.success) {
+        return `Error posting comment: ${result.error}`;
+    }
+    const data = result.data;
+    return `Comment posted successfully!\n- ID: ${data.id}\n- Type: ${data.comment_type}\n- Status: ${data.status}`;
+}
+// Create and configure server
+const server = new Server({
+    name: "foundationworks-mcp",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Register handlers
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools,
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        let result;
+        switch (name) {
+            case "foundation_menu":
+                result = await handleGetContextMenu();
+                break;
+            case "foundation_fetch":
+                if (!args?.sections || typeof args.sections !== "string") {
+                    result = "Error: 'sections' parameter is required";
+                }
+                else {
+                    result = await handleGetContext(args.sections);
+                }
+                break;
+            case "foundation_search":
+                if (!args?.query || typeof args.query !== "string") {
+                    result = "Error: 'query' parameter is required";
+                }
+                else {
+                    result = await handleSearchContext(args.query, typeof args.limit === "number" ? args.limit : undefined);
+                }
+                break;
+            case "foundation_comment":
+                if (!args?.document_type ||
+                    !args?.document_id ||
+                    !args?.section_key ||
+                    !args?.content) {
+                    result =
+                        "Error: document_type, document_id, section_key, and content are required";
+                }
+                else {
+                    result = await handlePostComment(args.document_type, args.document_id, args.section_key, args.content, args.comment_type || "deviation_report");
+                }
+                break;
+            default:
+                result = `Unknown tool: ${name}`;
+        }
+        return {
+            content: [{ type: "text", text: result }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Foundation MCP Server started");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    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/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "foundationworks-mcp",
+  "version": "0.1.0",
+  "description": "Connect your AI coding agent to your product specs in Foundation",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "foundationworks-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "start:local": "node -r dotenv/config dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "vitest run tests/e2e.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "foundation",
+    "prd",
+    "tdd",
+    "ai-agents"
+  ],
+  "author": "Foundation",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "dotenv": "^16.4.0",
+    "typescript": "^5.3.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/foundationworks/foundation.git",
+    "directory": "packages/mcp-server"
+  },
+  "homepage": "https://foundationworks.io",
+  "bugs": {
+    "url": "https://github.com/foundationworks/foundation/issues"
+  }
+}