@context-forge/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Manta Templates
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,102 @@
+# @context-forge/mcp
+
+An MCP server that generates structured context prompts for AI coding sessions. Configure your project once, then generate fresh, consistent context whenever you start a new session with Claude Code, Cursor, or any MCP-compatible tool.
+
+## What is this?
+
+Every productive AI coding session starts with context: what project you're working on, what slice or task is active, what conventions to follow, what happened in the last session. Context Forge assembles that context automatically from your project configuration and prompt templates.
+
+This MCP server exposes Context Forge's context engine as a set of tools that your AI assistant can call directly. Instead of manually copying and pasting context blocks, the assistant generates them on demand — staying current as your work progresses.
+
+## Why?
+
+Building context by hand is tedious. Every session, you're pulling together the same pieces: project state, current task, coding conventions, template sections. It takes several minutes, it's error-prone, and it breaks your flow.
+
+Context Forge eliminates that overhead. You configure your project once — templates, statements, project structure — and then generate a complete, structured context prompt with a single tool call. When you switch slices, change tasks, or reach a milestone, your assistant updates the project state and the next context generation reflects it automatically.
+
+## Quick Start
+
+### Install
+
+```bash
+# Run directly (no install needed)
+npx @context-forge/mcp
+
+# Or install globally
+npm install -g @context-forge/mcp
+```
+
+### Configure for Claude Code
+
+Add the server using the Claude Code CLI:
+
+```bash
+claude mcp add --transport stdio context-forge -- npx @context-forge/mcp
+```
+
+Or add it manually to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "context-forge": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["@context-forge/mcp"]
+    }
+  }
+}
+```
+
+### Configure for Cursor
+
+Add the following to your Cursor MCP settings (`.cursor/mcp.json` in your project root):
+
+```json
+{
+  "mcpServers": {
+    "context-forge": {
+      "command": "npx",
+      "args": ["@context-forge/mcp"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `project_list` | List all configured projects with summary fields |
+| `project_get` | Get full project details by ID |
+| `project_update` | Update project configuration (slice, instruction, phase, etc.) |
+| `context_build` | Generate a complete context prompt from project configuration |
+| `template_preview` | Preview context output without side effects |
+| `prompt_list` | List available prompt templates for a project |
+| `prompt_get` | Get the full content of a specific prompt template |
+| `context_summarize` | Update project session state (recent events, notes) |
+
+For full parameter details, see the [Tool Reference](../../docs/TOOLS.md).
+
+## Prerequisites
+
+- **Node.js 18+**
+- **ai-project-guide templates** set up in your project
+
+Context Forge uses prompt templates and project structure conventions from [ai-project-guide](https://github.com/ecorkran/ai-project-guide). To bootstrap the templates in your project:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/ecorkran/ai-project-guide/main/scripts/bootstrap.sh | bash
+```
+
+See the [ai-project-guide repository](https://github.com/ecorkran/ai-project-guide) for details on the methodology and template system.
+
+## Related
+
+- [Context Forge](../../README.md) — monorepo root with desktop app and full project documentation
+- [@context-forge/core](../core/README.md) — the context generation engine that powers this server
+- [ai-project-guide](https://github.com/ecorkran/ai-project-guide) — the template system and project methodology
+
+## License
+
+MIT

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,31 @@
+#!/usr/bin/env node
+// MCP SDK: @modelcontextprotocol/sdk v1.26.0 (v1 monolithic package)
+// Zod: v4.1.5 — imported as `z` from 'zod'
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerProjectTools } from './tools/projectTools.js';
+import { registerContextTools } from './tools/contextTools.js';
+import { registerStateTools } from './tools/stateTools.js';
+const SERVER_NAME = 'context-forge-mcp';
+const SERVER_VERSION = '0.1.0';
+function log(message) {
+    console.error(`[${SERVER_NAME}] ${message}`);
+}
+async function main() {
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    });
+    registerProjectTools(server);
+    registerContextTools(server);
+    registerStateTools(server);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log('Server started');
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`[${SERVER_NAME}] Fatal error: ${message}`);
+    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":";AACA,qEAAqE;AACrE,2CAA2C;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,WAAW,GAAG,mBAAmB,CAAC;AACxC,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,SAAS,GAAG,CAAC,OAAe;IAC1B,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACxB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,kBAAkB,OAAO,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/contextTools.d.ts

@@ -0,0 +1,28 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ProjectData } from '@context-forge/core';
+export declare function errorResult(message: string): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError: true;
+};
+export declare function textResult(text: string): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+};
+export declare function jsonResult(data: unknown): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+};
+/**
+ * Shared context generation helper used by context_build and template_preview.
+ * Loads a project, applies optional overrides, generates context via core pipeline.
+ */
+export declare function generateContext(projectId: string, overrides?: Partial<ProjectData>, additionalInstructions?: string): Promise<string>;
+export declare function registerContextTools(server: McpServer): void;
+//# sourceMappingURL=contextTools.d.ts.map

package/dist/tools/contextTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextTools.d.ts","sourceRoot":"","sources":["../../src/tools/contextTools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAEzG;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAEtF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAEvF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAChC,sBAAsB,CAAC,EAAE,MAAM,GAC9B,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAeD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwK5D"}

package/dist/tools/contextTools.js

@@ -0,0 +1,172 @@
+import * as path from 'node:path';
+import { z } from 'zod';
+import { FileProjectStore, createContextPipeline, SystemPromptParser } from '@context-forge/core/node';
+import { PROMPT_FILE_RELATIVE_PATH } from '@context-forge/core';
+// --- Shared helpers ---
+export function errorResult(message) {
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
+export function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function jsonResult(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+/**
+ * Shared context generation helper used by context_build and template_preview.
+ * Loads a project, applies optional overrides, generates context via core pipeline.
+ */
+export async function generateContext(projectId, overrides, additionalInstructions) {
+    const store = new FileProjectStore();
+    const project = await store.getById(projectId);
+    if (!project) {
+        throw new Error(`Project not found: '${projectId}'. Use the project_list tool to see available projects and their IDs.`);
+    }
+    if (!project.projectPath) {
+        throw new Error(`Project '${project.name}' has no configured project path. Set a project path before generating context.`);
+    }
+    // Create working copy with overrides applied
+    const workingCopy = { ...project };
+    if (overrides) {
+        for (const [key, value] of Object.entries(overrides)) {
+            if (value !== undefined) {
+                workingCopy[key] = value;
+            }
+        }
+    }
+    const { integrator } = createContextPipeline(workingCopy.projectPath);
+    let contextString = await integrator.generateContextFromProject(workingCopy);
+    if (additionalInstructions) {
+        contextString = `${contextString}\n\n${additionalInstructions}`;
+    }
+    return contextString;
+}
+/** Zod schema for optional project parameter overrides */
+const contextOverridesSchema = {
+    projectId: z.string().describe('Project ID. Use project_list to find IDs.'),
+    slice: z.string().optional().describe('Override the current slice name'),
+    taskFile: z.string().optional().describe('Override the task file name'),
+    instruction: z.string().optional().describe('Override the instruction type (e.g., implementation, design, review)'),
+    developmentPhase: z.string().optional().describe('Override the current development phase'),
+    workType: z.enum(['start', 'continue']).optional().describe('Override whether starting or continuing work'),
+    additionalInstructions: z.string().optional().describe('Additional instructions to append to the generated context'),
+};
+// --- Tool registration ---
+export function registerContextTools(server) {
+    // --- context_build ---
+    server.registerTool('context_build', {
+        title: 'Build Context',
+        description: 'Build a complete context prompt for a Context Forge project. This is the primary tool for generating structured context blocks. Optionally override project parameters (slice, instruction, etc.) without modifying the stored project. Returns the assembled context ready for use.',
+        inputSchema: contextOverridesSchema,
+        annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ projectId, additionalInstructions, ...overrideFields }) => {
+        try {
+            // Collect defined overrides
+            const overrides = {};
+            for (const [key, value] of Object.entries(overrideFields)) {
+                if (value !== undefined) {
+                    overrides[key] = value;
+                }
+            }
+            const contextString = await generateContext(projectId, Object.keys(overrides).length > 0 ? overrides : undefined, additionalInstructions);
+            return textResult(contextString);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(message);
+        }
+    });
+    // --- template_preview ---
+    server.registerTool('template_preview', {
+        title: 'Preview Context',
+        description: 'Preview a context prompt with specified parameters without modifying the stored project or triggering any side effects. Use this to explore what context would be generated with different configurations before committing to a context_build.',
+        inputSchema: contextOverridesSchema,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, async ({ projectId, additionalInstructions, ...overrideFields }) => {
+        try {
+            const overrides = {};
+            for (const [key, value] of Object.entries(overrideFields)) {
+                if (value !== undefined) {
+                    overrides[key] = value;
+                }
+            }
+            const contextString = await generateContext(projectId, Object.keys(overrides).length > 0 ? overrides : undefined, additionalInstructions);
+            return textResult(contextString);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(message);
+        }
+    });
+    // --- prompt_list ---
+    server.registerTool('prompt_list', {
+        title: 'List Prompts',
+        description: 'List available prompt templates for a Context Forge project. Returns template names and metadata. Use prompt_get to retrieve the full content of a specific template.',
+        inputSchema: {
+            projectId: z.string().describe('Project ID. Use project_list to find IDs.'),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ projectId }) => {
+        try {
+            const store = new FileProjectStore();
+            const project = await store.getById(projectId);
+            if (!project) {
+                return errorResult(`Project not found: '${projectId}'. Use the project_list tool to see available projects and their IDs.`);
+            }
+            if (!project.projectPath) {
+                return errorResult(`Project '${project.name}' has no configured project path. Set a project path before listing prompts.`);
+            }
+            const promptFilePath = path.join(project.projectPath, PROMPT_FILE_RELATIVE_PATH);
+            const parser = new SystemPromptParser(promptFilePath);
+            const prompts = await parser.getAllPrompts();
+            const templates = prompts.map((p) => ({
+                name: p.name,
+                key: p.key,
+                parameterCount: p.parameters.length,
+            }));
+            return jsonResult({ templates, count: templates.length, promptFile: promptFilePath });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(message);
+        }
+    });
+    // --- prompt_get ---
+    server.registerTool('prompt_get', {
+        title: 'Get Prompt',
+        description: 'Get the full content of a specific prompt template. Returns the raw template text. Useful for inspecting what a template contains before building context with it.',
+        inputSchema: {
+            projectId: z.string().describe('Project ID. Use project_list to find IDs.'),
+            templateName: z.string().describe('Template name or key to match. Use prompt_list to see available templates.'),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ projectId, templateName }) => {
+        try {
+            const store = new FileProjectStore();
+            const project = await store.getById(projectId);
+            if (!project) {
+                return errorResult(`Project not found: '${projectId}'. Use the project_list tool to see available projects and their IDs.`);
+            }
+            if (!project.projectPath) {
+                return errorResult(`Project '${project.name}' has no configured project path. Set a project path before retrieving prompts.`);
+            }
+            const promptFilePath = path.join(project.projectPath, PROMPT_FILE_RELATIVE_PATH);
+            const parser = new SystemPromptParser(promptFilePath);
+            const prompts = await parser.getAllPrompts();
+            // Match by name (case-insensitive) or key (exact)
+            const templateNameLower = templateName.toLowerCase();
+            const match = prompts.find((p) => p.name.toLowerCase() === templateNameLower || p.key === templateName);
+            if (!match) {
+                return errorResult(`Template not found: '${templateName}'. Use the prompt_list tool to see available templates for this project.`);
+            }
+            // Return metadata header followed by template content
+            const header = `# ${match.name}\nKey: ${match.key}\nParameters: ${match.parameters.join(', ') || 'none'}\n\n---\n\n`;
+            return textResult(header + match.content);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(message);
+        }
+    });
+}
+//# sourceMappingURL=contextTools.js.map

package/dist/tools/contextTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextTools.js","sourceRoot":"","sources":["../../src/tools/contextTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACvG,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,yBAAyB;AAEzB,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAiB,EACjB,SAAgC,EAChC,sBAA+B;IAE/B,MAAM,KAAK,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,uBAAuB,SAAS,uEAAuE,CACxG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,YAAY,OAAO,CAAC,IAAI,iFAAiF,CAC1G,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,MAAM,WAAW,GAAgB,EAAE,GAAG,OAAO,EAAE,CAAC;IAChD,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACvB,WAAkD,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,GAAG,qBAAqB,CAAC,WAAW,CAAC,WAAY,CAAC,CAAC;IACvE,IAAI,aAAa,GAAG,MAAM,UAAU,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAC;IAE7E,IAAI,sBAAsB,EAAE,CAAC;QAC3B,aAAa,GAAG,GAAG,aAAa,OAAO,sBAAsB,EAAE,CAAC;IAClE,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,0DAA0D;AAC1D,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC3E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACxE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACvE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;IACnH,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAC1F,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAC3G,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;CACrH,CAAC;AAEF,4BAA4B;AAE5B,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,wBAAwB;IACxB,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,sRAAsR;QACxR,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KACjF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,sBAAsB,EAAE,GAAG,cAAc,EAAE,EAAE,EAAE;QACjE,IAAI,CAAC;YACH,4BAA4B;YAC5B,MAAM,SAAS,GAAyB,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC1D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACvB,SAAgD,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACjE,CAAC;YACH,CAAC;YAED,MAAM,aAAa,GAAG,MAAM,eAAe,CACzC,SAAS,EACT,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EACzD,sBAAsB,CACvB,CAAC;YACF,OAAO,UAAU,CAAC,aAAa,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,2BAA2B;IAC3B,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,iPAAiP;QACnP,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAChF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,sBAAsB,EAAE,GAAG,cAAc,EAAE,EAAE,EAAE;QACjE,IAAI,CAAC;YACH,MAAM,SAAS,GAAyB,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC1D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACvB,SAAgD,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACjE,CAAC;YACH,CAAC;YAED,MAAM,aAAa,GAAG,MAAM,eAAe,CACzC,SAAS,EACT,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EACzD,sBAAsB,CACvB,CAAC;YACF,OAAO,UAAU,CAAC,aAAa,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,sBAAsB;IACtB,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,uKAAuK;QACzK,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;SAC5E;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1D,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,gBAAgB,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAE/C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,WAAW,CAChB,uBAAuB,SAAS,uEAAuE,CACxG,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;gBACzB,OAAO,WAAW,CAChB,YAAY,OAAO,CAAC,IAAI,8EAA8E,CACvG,CAAC;YACJ,CAAC;YAED,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC;YACjF,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,cAAc,CAAC,CAAC;YACtD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;YAE7C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,cAAc,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM;aACpC,CAAC,CAAC,CAAC;YAEJ,OAAO,UAAU,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC;QACxF,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,qBAAqB;IACrB,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,oKAAoK;QACtK,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YAC3E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;SAChH;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1D,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE;QACpC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,gBAAgB,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAE/C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,WAAW,CAChB,uBAAuB,SAAS,uEAAuE,CACxG,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;gBACzB,OAAO,WAAW,CAChB,YAAY,OAAO,CAAC,IAAI,iFAAiF,CAC1G,CAAC;YACJ,CAAC;YAED,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC;YACjF,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,cAAc,CAAC,CAAC;YACtD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;YAE7C,kDAAkD;YAClD,MAAM,iBAAiB,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CACxB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,iBAAiB,IAAI,CAAC,CAAC,GAAG,KAAK,YAAY,CAC5E,CAAC;YAEF,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,WAAW,CAChB,wBAAwB,YAAY,0EAA0E,CAC/G,CAAC;YACJ,CAAC;YAED,sDAAsD;YACtD,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,GAAG,iBAAiB,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,aAAa,CAAC;YACrH,OAAO,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/projectTools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerProjectTools(server: McpServer): void;
+//# sourceMappingURL=projectTools.d.ts.map

package/dist/tools/projectTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectTools.d.ts","sourceRoot":"","sources":["../../src/tools/projectTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsCpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0H5D"}

package/dist/tools/projectTools.js

@@ -0,0 +1,119 @@
+import { z } from 'zod';
+import { FileProjectStore } from '@context-forge/core/node';
+function toSummary(project) {
+    return {
+        id: project.id,
+        name: project.name,
+        slice: project.slice,
+        template: project.template,
+        instruction: project.instruction,
+        isMonorepo: project.isMonorepo,
+        projectPath: project.projectPath,
+        updatedAt: project.updatedAt,
+    };
+}
+function errorResult(message) {
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
+function jsonResult(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+export function registerProjectTools(server) {
+    // --- project_list ---
+    server.registerTool('project_list', {
+        title: 'List Projects',
+        description: 'List all configured Context Forge projects. Returns project IDs, names, current slices, and other summary fields. Use this to discover available projects before calling project_get or project_update.',
+        inputSchema: {},
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async () => {
+        try {
+            const store = new FileProjectStore();
+            const allProjects = await store.getAll();
+            const projects = allProjects.map(toSummary);
+            return jsonResult({ projects, count: projects.length });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(`Error: ${message}`);
+        }
+    });
+    // --- project_get ---
+    server.registerTool('project_get', {
+        title: 'Get Project',
+        description: 'Get full details for a specific Context Forge project by ID. Returns all project fields including configuration, custom data, and timestamps. Use project_list first to find project IDs.',
+        inputSchema: {
+            id: z.string().describe('Project ID (e.g., project_1739...). Use project_list to find IDs.'),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ id }) => {
+        try {
+            const store = new FileProjectStore();
+            const project = await store.getById(id);
+            if (!project) {
+                return errorResult(`Project not found: '${id}'. Use the project_list tool to see available projects and their IDs.`);
+            }
+            return jsonResult(project);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(`Error: ${message}`);
+        }
+    });
+    // --- project_update ---
+    server.registerTool('project_update', {
+        title: 'Update Project',
+        description: 'Update configuration fields on an existing Context Forge project. Provide the project ID and any fields to change (e.g., slice, instruction, developmentPhase). Returns the full updated project. Does not delete or replace — only modifies specified fields.',
+        inputSchema: {
+            id: z.string().describe('Project ID to update'),
+            name: z.string().optional().describe('Project display name'),
+            template: z.string().optional().describe('Template name'),
+            slice: z.string().optional().describe('Current slice name'),
+            taskFile: z.string().optional().describe('Task file name'),
+            instruction: z.string().optional().describe('Instruction type (e.g., implementation, design, review)'),
+            developmentPhase: z.string().optional().describe('Current development phase'),
+            workType: z.enum(['start', 'continue']).optional().describe('Whether starting or continuing work'),
+            projectDate: z.string().optional().describe('Project date string'),
+            isMonorepo: z.boolean().optional().describe('Whether project uses monorepo mode'),
+            isMonorepoEnabled: z.boolean().optional().describe('Whether monorepo UI is enabled'),
+            projectPath: z.string().optional().describe('Absolute path to project root'),
+            customData: z
+                .object({
+                recentEvents: z.string().optional(),
+                additionalNotes: z.string().optional(),
+                monorepoNote: z.string().optional(),
+                availableTools: z.string().optional(),
+            })
+                .optional()
+                .describe('Custom data fields for context generation'),
+        },
+        annotations: { destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ id, ...fields }) => {
+        try {
+            // Collect defined update fields (exclude undefined values)
+            const updates = {};
+            for (const [key, value] of Object.entries(fields)) {
+                if (value !== undefined) {
+                    updates[key] = value;
+                }
+            }
+            if (Object.keys(updates).length === 0) {
+                return errorResult('No update fields provided. Specify at least one field to update (e.g., slice, instruction, name).');
+            }
+            const store = new FileProjectStore();
+            // Check project exists
+            const existing = await store.getById(id);
+            if (!existing) {
+                return errorResult(`Project not found: '${id}'. Use the project_list tool to see available projects and their IDs.`);
+            }
+            await store.update(id, updates);
+            // Read back updated project
+            const updated = await store.getById(id);
+            return jsonResult(updated);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(`Error: ${message}`);
+        }
+    });
+}
+//# sourceMappingURL=projectTools.js.map

package/dist/tools/projectTools.js.map

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

package/dist/tools/stateTools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerStateTools(server: McpServer): void;
+//# sourceMappingURL=stateTools.d.ts.map

package/dist/tools/stateTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateTools.d.ts","sourceRoot":"","sources":["../../src/tools/stateTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiE1D"}

package/dist/tools/stateTools.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { FileProjectStore } from '@context-forge/core/node';
+import { errorResult, jsonResult } from './contextTools.js';
+export function registerStateTools(server) {
+    // --- context_summarize ---
+    server.registerTool('context_summarize', {
+        title: 'Summarize Context',
+        description: "Update a project's session state summary. Persists the provided summary text as the project's recent events, " +
+            'which will be included in subsequent context_build output. Use this after significant work milestones, context ' +
+            "switches, or to record session progress for continuity. Analogous to Claude Code's /compact but for project-level state.",
+        inputSchema: {
+            projectId: z.string().describe('Project ID to update. Use project_list to find IDs.'),
+            summary: z
+                .string()
+                .describe('Summary of recent events, session progress, or current project state. ' +
+                'This replaces the current recentEvents field and will appear in subsequent context_build output.'),
+            additionalNotes: z
+                .string()
+                .optional()
+                .describe('Optional additional notes to persist alongside the summary. ' +
+                'Replaces the current additionalNotes field if provided.'),
+        },
+        annotations: { destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ projectId, summary, additionalNotes }) => {
+        try {
+            // Validate non-empty summary
+            if (!summary.trim()) {
+                return errorResult('Summary text is required. Provide a non-empty summary of recent events or session state.');
+            }
+            const store = new FileProjectStore();
+            // Check project exists
+            const existing = await store.getById(projectId);
+            if (!existing) {
+                return errorResult(`Project not found: '${projectId}'. Use the project_list tool to see available projects and their IDs.`);
+            }
+            // Merge customData: preserve existing fields, overlay summary + optional additionalNotes
+            const mergedCustomData = {
+                ...existing.customData,
+                recentEvents: summary,
+                ...(additionalNotes !== undefined && { additionalNotes }),
+            };
+            await store.update(projectId, { customData: mergedCustomData });
+            // Read back updated project
+            const updated = await store.getById(projectId);
+            return jsonResult(updated);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(`Error: ${message}`);
+        }
+    });
+}
+//# sourceMappingURL=stateTools.js.map

package/dist/tools/stateTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateTools.js","sourceRoot":"","sources":["../../src/tools/stateTools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,4BAA4B;IAC5B,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,+GAA+G;YAC/G,iHAAiH;YACjH,0HAA0H;QAC5H,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;YACrF,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,CACP,wEAAwE;gBACtE,kGAAkG,CACrG;YACH,eAAe,EAAE,CAAC;iBACf,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,8DAA8D;gBAC5D,yDAAyD,CAC5D;SACJ;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KACpF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE;QAChD,IAAI,CAAC;YACH,6BAA6B;YAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBACpB,OAAO,WAAW,CAChB,0FAA0F,CAC3F,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,gBAAgB,EAAE,CAAC;YAErC,uBAAuB;YACvB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,WAAW,CAChB,uBAAuB,SAAS,uEAAuE,CACxG,CAAC;YACJ,CAAC;YAED,yFAAyF;YACzF,MAAM,gBAAgB,GAAG;gBACvB,GAAG,QAAQ,CAAC,UAAU;gBACtB,YAAY,EAAE,OAAO;gBACrB,GAAG,CAAC,eAAe,KAAK,SAAS,IAAI,EAAE,eAAe,EAAE,CAAC;aAC1D,CAAC;YAEF,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC,CAAC;YAEhE,4BAA4B;YAC5B,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC/C,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,WAAW,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@context-forge/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Context Forge — generates structured AI context prompts from project configuration and templates",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "context-forge-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "context",
+    "ai",
+    "claude",
+    "cursor",
+    "prompt",
+    "context-forge"
+  ],
+  "author": "Manta Templates",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ecorkran/context-forge.git",
+    "directory": "packages/mcp-server"
+  },
+  "homepage": "https://github.com/ecorkran/context-forge/tree/main/packages/mcp-server#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^4.1.5",
+    "@context-forge/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "typescript": "~5.8.3",
+    "vitest": "^3.2.1"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}