@iflow-mcp/apple-rag-mcp 4.6.2

package/src/worker.ts

@@ -0,0 +1,176 @@
+/**
+ * Apple RAG MCP Server - Cloudflare Worker Native
+ * Ultra-modern, zero-dependency MCP 2025-06-18 compliant server
+ * Global optimal solution with maximum performance
+ */
+
+import { HEALTH_STATUS, SERVER_MANIFEST } from "./mcp/manifest.js";
+import { MCPProtocolHandler } from "./mcp/protocol-handler.js";
+import { createServices } from "./services/index.js";
+import type { WorkerEnv } from "./types/index.js";
+import { logger } from "./utils/logger.js";
+import { configureTelegram } from "./utils/telegram-notifier.js";
+
+/**
+ * Cloudflare Worker entry point - Global optimal implementation
+ * Handles all MCP protocol requests with edge-optimized performance
+ */
+export default {
+  async fetch(
+    request: Request,
+    env: WorkerEnv,
+    ctx: ExecutionContext
+  ): Promise<Response> {
+    const startTime = performance.now();
+
+    // Configure Telegram notification and set execution context for waitUntil
+    configureTelegram(env.TELEGRAM_BOT_URL);
+    logger.setContext(ctx);
+
+    try {
+      const url = new URL(request.url);
+
+      // Health check endpoint - ultra-fast response
+      if (request.method === "GET" && url.pathname === "/health") {
+        return new Response(
+          JSON.stringify({
+            ...HEALTH_STATUS,
+            timestamp: new Date().toISOString(),
+          }),
+          {
+            status: 200,
+            headers: {
+              "Content-Type": "application/json",
+              "Cache-Control": "no-cache",
+            },
+          }
+        );
+      }
+
+      // Manifest endpoint - server discovery
+      if (request.method === "GET" && url.pathname === "/manifest") {
+        return new Response(JSON.stringify(SERVER_MANIFEST), {
+          status: 200,
+          headers: {
+            "Content-Type": "application/json",
+            "Cache-Control": "public, max-age=3600",
+          },
+        });
+      }
+
+      // Reject other GET requests to the MCP endpoint
+      if (request.method === "GET" && url.pathname === "/") {
+        return new Response("Method Not Allowed", {
+          status: 405,
+          headers: {
+            "Access-Control-Allow-Origin": "*",
+            Allow: "POST, OPTIONS",
+          },
+        });
+      }
+
+      // Handle POST /manifest requests (VPS compatibility)
+      if (request.method === "POST" && url.pathname === "/manifest") {
+        try {
+          const body = await request.json();
+
+          // Empty body → return manifest (common client behavior)
+          if (!body || Object.keys(body).length === 0) {
+            return new Response(JSON.stringify(SERVER_MANIFEST), {
+              status: 200,
+              headers: { "Content-Type": "application/json" },
+            });
+          }
+
+          // MCP request to wrong endpoint → redirect to correct endpoint
+          if (
+            (body as unknown as { jsonrpc?: string; method?: string })
+              .jsonrpc === "2.0" &&
+            (body as unknown as { jsonrpc?: string; method?: string }).method
+          ) {
+            return new Response(
+              JSON.stringify({
+                error: "Endpoint redirect",
+                message: "MCP protocol requests should be sent to /",
+                redirect: "/",
+              }),
+              {
+                status: 307,
+                headers: {
+                  "Content-Type": "application/json",
+                  Location: "/",
+                },
+              }
+            );
+          }
+
+          // Any other POST data → helpful error
+          return new Response(
+            JSON.stringify({
+              error: "Invalid manifest request",
+              message:
+                "Use GET /manifest for server discovery or POST / for MCP communication",
+              endpoints: {
+                manifest: "GET /manifest",
+                mcp: "POST /",
+              },
+            }),
+            {
+              status: 400,
+              headers: { "Content-Type": "application/json" },
+            }
+          );
+        } catch (_error) {
+          return new Response(
+            JSON.stringify({
+              error: "Invalid JSON",
+              message: "Request body must be valid JSON",
+            }),
+            {
+              status: 400,
+              headers: { "Content-Type": "application/json" },
+            }
+          );
+        }
+      }
+
+      // Initialize services with Worker environment
+      const services = await createServices(env);
+
+      // Authenticate request using auth service
+      const authContext = await services.auth.optionalAuth(request);
+
+      // Create MCP protocol handler
+      const handler = new MCPProtocolHandler(services);
+
+      // Handle MCP request
+      const response = await handler.handleRequest(request, authContext);
+
+      return response;
+    } catch (error) {
+      const duration = performance.now() - startTime;
+      const errorUrl = new URL(request.url);
+
+      logger.error(
+        `Worker error for ${request.method} ${errorUrl.pathname} (duration: ${Math.round(duration)}ms): ${error instanceof Error ? error.message : String(error)}`
+      );
+
+      return new Response(
+        JSON.stringify({
+          jsonrpc: "2.0",
+          error: {
+            code: -32603,
+            message: "Internal server error",
+          },
+        }),
+        {
+          status: 500,
+          headers: {
+            "Content-Type": "application/json",
+            "Cache-Control": "no-cache",
+          },
+        }
+      );
+    }
+  },
+};

package/tsconfig.json

@@ -0,0 +1,32 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "ESNext",
+    "moduleResolution": "Node",
+    "skipLibCheck": true,
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+
+    "outDir": "./dist",
+    "rootDir": "./",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitReturns": true,
+    "noImplicitOverride": true,
+
+    "forceConsistentCasingInFileNames": true,
+
+    "types": ["node", "@cloudflare/workers-types"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "logs", "**/*.test.ts"]
+}

package/wrangler.toml.example

@@ -0,0 +1,39 @@
+name = "apple-rag-mcp"
+main = "src/worker.ts"
+compatibility_date = "2024-12-01"
+compatibility_flags = ["nodejs_compat"]
+
+# Cloudflare Workers Logs Configuration
+[observability]
+enabled = true
+head_sampling_rate = 1
+
+# Smart Placement Configuration
+# Automatically places Worker closer to your database for better performance
+[placement]
+mode = "smart"
+
+# Shared configuration for all environments
+# Replace with your actual values
+[vars]
+RAG_DB_HOST = "your_postgresql_host"
+RAG_DB_PORT = "5432"
+RAG_DB_DATABASE = "your_database_name"
+RAG_DB_USER = "your_database_user"
+RAG_DB_PASSWORD = "your_database_password"
+RAG_DB_SSLMODE = "disable"
+TELEGRAM_BOT_URL = "your_telegram_bot_url"
+
+# Development environment D1 database
+# Replace with your own D1 database configuration
+[[d1_databases]]
+binding = "DB"
+database_name = "your_d1_database_name"
+database_id = "your_d1_database_id"
+
+# Production environment D1 database
+# Replace with your own production D1 database configuration
+[[env.production.d1_databases]]
+binding = "DB"
+database_name = "your_production_d1_database_name"
+database_id = "your_production_d1_database_id"