ai-context-sync-mcp 1.0.0

package/.env

@@ -0,0 +1,3 @@
+# MCP Server Configuration
+CONTEXT_SYNC_API_KEY=your-api-key-here
+CONTEXT_SYNC_BACKEND_URL=http://localhost:8000

package/.env.example

@@ -0,0 +1,3 @@
+# MCP Server Configuration
+CONTEXT_SYNC_API_KEY=your-api-key-here
+CONTEXT_SYNC_BACKEND_URL=http://localhost:8000

package/build/index.js

@@ -0,0 +1,219 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import dotenv from "dotenv";
+import path from "path";
+dotenv.config();
+const API_KEY = process.env.CONTEXT_SYNC_API_KEY;
+const BACKEND_URL = process.env.CONTEXT_SYNC_BACKEND_URL || "http://127.0.0.1:8000";
+const CLIENT_INFO = process.env.CONTEXT_SYNC_CLIENT || "MCP Server";
+if (!API_KEY) {
+    console.error("Warning: CONTEXT_SYNC_API_KEY environment variable is not set. MCP tools will fail authorization check.");
+}
+const server = new Server({
+    name: "context-sync-mcp",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Register available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "push_context",
+                description: "Save a new chat context, summary, or feature description to the Context-Sync backend so it can be restored or queried later.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        projectName: {
+                            type: "string",
+                            description: "The name of the project this context belongs to."
+                        },
+                        contextName: {
+                            type: "string",
+                            description: "A short descriptive name for this context block (e.g. 'auth-logic', 'main-db-schema')."
+                        },
+                        contextDescription: {
+                            type: "string",
+                            description: "A detailed explanation of what this context is about, helping semantic search locate it later."
+                        },
+                        contextData: {
+                            type: "string",
+                            description: "The actual code context, chat history, or serialized message transcripts to save."
+                        },
+                        contextType: {
+                            type: "string",
+                            enum: ["full", "summary", "feature"],
+                            description: "The type of context being saved."
+                        }
+                    },
+                    required: ["contextData"]
+                }
+            },
+            {
+                name: "pull_context",
+                description: "Retrieve a saved chat context, summary, or feature description from the Context-Sync backend by searching for it.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        searchQuery: {
+                            type: "string",
+                            description: "Describe what context you need (e.g. 'how did we setup JWT authentication?')."
+                        },
+                        projectName: {
+                            type: "string",
+                            description: "Optional. Restrict search to this specific project name."
+                        }
+                    },
+                    required: ["searchQuery"]
+                }
+            }
+        ]
+    };
+});
+// Handle tool execution requests
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    if (!API_KEY) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Error: CONTEXT_SYNC_API_KEY environment variable is missing on the MCP server. Configure it with your API key from the web dashboard.",
+                },
+            ],
+            isError: true,
+        };
+    }
+    if (name === "push_context") {
+        const { projectName, contextName, contextDescription, contextData, contextType } = args;
+        // Resolve fallbacks for optional parameters
+        const defaultProject = path.basename(process.cwd()) || "default-project";
+        const resolvedProjectName = projectName || defaultProject;
+        const timestamp = new Date().toISOString().slice(0, 10);
+        const resolvedContextName = contextName || `session-${timestamp}`;
+        const resolvedContextDescription = contextDescription || "Automatically synchronized development context block.";
+        const resolvedContextType = contextType || "full";
+        try {
+            const response = await fetch(`${BACKEND_URL}/api/mcp/push`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "X-API-Key": API_KEY,
+                    "X-Client-Info": CLIENT_INFO,
+                },
+                body: JSON.stringify({
+                    project_name: resolvedProjectName,
+                    context_name: resolvedContextName,
+                    context_description: resolvedContextDescription,
+                    context_data: contextData,
+                    type: resolvedContextType,
+                }),
+            });
+            if (!response.ok) {
+                const errData = await response.json().catch(() => ({ detail: "Unknown backend error" }));
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Failed to push context: ${errData.detail || response.statusText}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const result = await response.json();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Successfully pushed context '${resolvedContextName}' to project '${resolvedProjectName}'! Size: ${contextData.length} characters.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Network error connecting to backend: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    if (name === "pull_context") {
+        const { searchQuery, projectName } = args;
+        try {
+            const response = await fetch(`${BACKEND_URL}/api/mcp/pull`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "X-API-Key": API_KEY,
+                    "X-Client-Info": CLIENT_INFO,
+                },
+                body: JSON.stringify({
+                    search_query: searchQuery,
+                    project_name: projectName || null,
+                }),
+            });
+            if (!response.ok) {
+                const errData = await response.json().catch(() => ({ detail: "Unknown backend error" }));
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Failed to pull context: ${errData.detail || response.statusText}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const result = await response.json();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Successfully retrieved matching context!\n\n` +
+                            `Project: ${result.project_name}\n` +
+                            `Context Name: ${result.name}\n` +
+                            `Description: ${result.description}\n` +
+                            `Type: ${result.type}\n` +
+                            `Last Updated: ${result.updated_at}\n\n` +
+                            `--- CONTEXT DATA ---\n` +
+                            `${result.context_data}\n` +
+                            `-------------------`
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Network error connecting to backend: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    throw new Error(`Tool not found: ${name}`);
+});
+// Run server on stdio transport
+async function run() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Context-Sync MCP Server running on stdio transport");
+}
+run().catch((error) => {
+    console.error("Fatal error running MCP server:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "ai-context-sync-mcp",
+  "version": "1.0.0",
+  "description": "Model Context Protocol Server for Context-Sync-MCP",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "ai-context-sync-mcp": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.6.0",
+    "dotenv": "^16.4.5"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.24",
+    "typescript": "^5.3.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,243 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import dotenv from "dotenv";
+import path from "path";
+
+dotenv.config();
+
+const API_KEY = process.env.CONTEXT_SYNC_API_KEY;
+const BACKEND_URL = process.env.CONTEXT_SYNC_BACKEND_URL || "http://127.0.0.1:8000";
+const CLIENT_INFO = process.env.CONTEXT_SYNC_CLIENT || "MCP Server";
+
+if (!API_KEY) {
+  console.error("Warning: CONTEXT_SYNC_API_KEY environment variable is not set. MCP tools will fail authorization check.");
+}
+
+const server = new Server(
+  {
+    name: "context-sync-mcp",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// Register available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: "push_context",
+        description: "Save a new chat context, summary, or feature description to the Context-Sync backend so it can be restored or queried later.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            projectName: {
+              type: "string",
+              description: "The name of the project this context belongs to."
+            },
+            contextName: {
+              type: "string",
+              description: "A short descriptive name for this context block (e.g. 'auth-logic', 'main-db-schema')."
+            },
+            contextDescription: {
+              type: "string",
+              description: "A detailed explanation of what this context is about, helping semantic search locate it later."
+            },
+            contextData: {
+              type: "string",
+              description: "The actual code context, chat history, or serialized message transcripts to save."
+            },
+            contextType: {
+              type: "string",
+              enum: ["full", "summary", "feature"],
+              description: "The type of context being saved."
+            }
+          },
+          required: ["contextData"]
+        }
+      },
+      {
+        name: "pull_context",
+        description: "Retrieve a saved chat context, summary, or feature description from the Context-Sync backend by searching for it.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            searchQuery: {
+              type: "string",
+              description: "Describe what context you need (e.g. 'how did we setup JWT authentication?')."
+            },
+            projectName: {
+              type: "string",
+              description: "Optional. Restrict search to this specific project name."
+            }
+          },
+          required: ["searchQuery"]
+        }
+      }
+    ]
+  };
+});
+
+// Handle tool execution requests
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  if (!API_KEY) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: "Error: CONTEXT_SYNC_API_KEY environment variable is missing on the MCP server. Configure it with your API key from the web dashboard.",
+        },
+      ],
+      isError: true,
+    };
+  }
+
+  if (name === "push_context") {
+    const { projectName, contextName, contextDescription, contextData, contextType } = args as any;
+
+    // Resolve fallbacks for optional parameters
+    const defaultProject = path.basename(process.cwd()) || "default-project";
+    const resolvedProjectName = projectName || defaultProject;
+
+    const timestamp = new Date().toISOString().slice(0, 10);
+    const resolvedContextName = contextName || `session-${timestamp}`;
+
+    const resolvedContextDescription = contextDescription || "Automatically synchronized development context block.";
+    const resolvedContextType = contextType || "full";
+
+    try {
+      const response = await fetch(`${BACKEND_URL}/api/mcp/push`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-API-Key": API_KEY,
+          "X-Client-Info": CLIENT_INFO,
+        },
+        body: JSON.stringify({
+          project_name: resolvedProjectName,
+          context_name: resolvedContextName,
+          context_description: resolvedContextDescription,
+          context_data: contextData,
+          type: resolvedContextType,
+        }),
+      });
+
+      if (!response.ok) {
+        const errData = await response.json().catch(() => ({ detail: "Unknown backend error" }));
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to push context: ${errData.detail || response.statusText}`,
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      const result = await response.json();
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Successfully pushed context '${resolvedContextName}' to project '${resolvedProjectName}'! Size: ${contextData.length} characters.`,
+          },
+        ],
+      };
+    } catch (error: any) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Network error connecting to backend: ${error.message}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  }
+
+  if (name === "pull_context") {
+    const { searchQuery, projectName } = args as any;
+    try {
+      const response = await fetch(`${BACKEND_URL}/api/mcp/pull`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-API-Key": API_KEY,
+          "X-Client-Info": CLIENT_INFO,
+        },
+        body: JSON.stringify({
+          search_query: searchQuery,
+          project_name: projectName || null,
+        }),
+      });
+
+      if (!response.ok) {
+        const errData = await response.json().catch(() => ({ detail: "Unknown backend error" }));
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to pull context: ${errData.detail || response.statusText}`,
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      const result: any = await response.json();
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Successfully retrieved matching context!\n\n` +
+                  `Project: ${result.project_name}\n` +
+                  `Context Name: ${result.name}\n` +
+                  `Description: ${result.description}\n` +
+                  `Type: ${result.type}\n` +
+                  `Last Updated: ${result.updated_at}\n\n` +
+                  `--- CONTEXT DATA ---\n` +
+                  `${result.context_data}\n` +
+                  `-------------------`
+          },
+        ],
+      };
+    } catch (error: any) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Network error connecting to backend: ${error.message}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  }
+
+  throw new Error(`Tool not found: ${name}`);
+});
+
+// Run server on stdio transport
+async function run() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Context-Sync MCP Server running on stdio transport");
+}
+
+run().catch((error) => {
+  console.error("Fatal error running MCP server:", error);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./build",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"]
+}