@nebutra/mcp 0.1.0

package/src/server/contextServer.ts

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+
+import fs from "node:fs";
+import path from "node:path";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListResourcesRequestSchema,
+  ListToolsRequestSchema,
+  ReadResourceRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+/**
+ * Nebutra MCP Context Server
+ * Exposes core project files and state to Cursor / Windsurf allowing AI Agents
+ * to instantly understand the Nebutra-Sailor application structure and routing logic.
+ */
+class NebutraContextServer {
+  private server: Server;
+  private projectRoot: string;
+
+  constructor(projectRoot?: string) {
+    this.projectRoot = projectRoot || process.cwd();
+
+    this.server = new Server(
+      {
+        name: "@nebutra/context-server",
+        version: "0.1.0",
+      },
+      {
+        capabilities: {
+          resources: {},
+          tools: {},
+        },
+      },
+    );
+
+    this.setupResourceHandlers();
+    this.setupToolHandlers();
+
+    this.server.onerror = (_error) => {};
+  }
+
+  private setupResourceHandlers() {
+    this.server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+      resources: [
+        {
+          uri: "file:///nebutra.config.json",
+          name: "Nebutra Configuration",
+          mimeType: "application/json",
+          description:
+            "Global configurations for the Nebutra template including enabled features (auth, payments, i18n, db).",
+        },
+        {
+          uri: "file:///prisma/schema.prisma",
+          name: "Database Schema Overview",
+          mimeType: "text/plain",
+          description: "The core Prisma schema defining the database tables and relationships.",
+        },
+      ],
+    }));
+
+    this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+      const { uri } = request.params;
+
+      let filePath = "";
+      if (uri === "file:///nebutra.config.json") {
+        filePath = path.join(this.projectRoot, "nebutra.config.json");
+      } else if (uri === "file:///prisma/schema.prisma") {
+        filePath = path.join(this.projectRoot, "packages/platform/db/prisma/schema.prisma");
+      } else {
+        throw new Error(`Resource not found: ${uri}`);
+      }
+
+      try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        return {
+          contents: [
+            {
+              uri,
+              mimeType: uri.endsWith(".json") ? "application/json" : "text/plain",
+              text: content,
+            },
+          ],
+        };
+      } catch {
+        throw new Error(`Failed to read the requested resource file at ${filePath}`);
+      }
+    });
+  }
+
+  private setupToolHandlers() {
+    this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+      tools: [
+        {
+          name: "get_project_structure",
+          description: "Retrieves the core Next.js routing tree from the apps folder.",
+          inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+          },
+        },
+      ],
+    }));
+
+    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+      if (request.params.name === "get_project_structure") {
+        try {
+          const appsDir = path.join(this.projectRoot, "apps");
+          if (!fs.existsSync(appsDir))
+            return { content: [{ type: "text", text: "Apps dir not found." }] };
+          const dirs = fs.readdirSync(appsDir);
+          return { content: [{ type: "text", text: `Apps: ${dirs.join(", ")}` }] };
+        } catch (error) {
+          return { content: [{ type: "text", text: `Error: ${error}` }], isError: true };
+        }
+      }
+      throw new Error(`Unknown tool: ${request.params.name}`);
+    });
+  }
+
+  async run() {
+    const transport = new StdioServerTransport();
+    await this.server.connect(transport);
+  }
+}
+
+// Export a factory or run directly if invoked as script
+export const startContextServer = () => {
+  const server = new NebutraContextServer();
+  server.run().catch(console.error);
+};
+
+if (process.argv[1]?.endsWith("contextServer.js") || process.argv[1]?.endsWith("nebutra-mcp")) {
+  startContextServer();
+}

package/src/server/index.ts

@@ -0,0 +1,5 @@
+export {
+  getInternalServerIds,
+  INTERNAL_SERVERS,
+  registerInternalServers,
+} from "./internalServers";

package/src/server/internalServers.ts

@@ -0,0 +1,70 @@
+import { serverRegistry } from "../registry/serverRegistry";
+import type { MCPServerConfig } from "../types";
+
+/**
+ * Register internal Nebutra services as MCP servers
+ * These wrap our existing microservices with MCP-compatible interfaces
+ */
+
+export const INTERNAL_SERVERS: MCPServerConfig[] = [
+  // AI Service
+  {
+    id: "nebutra-ai",
+    name: "Nebutra AI Service",
+    description: "AI-powered text generation, embedding, and translation",
+    endpoint: process.env.AI_SERVICE_URL || "http://localhost:8001",
+    transport: "http",
+    tools: [
+      {
+        name: "generate_text",
+        description: "Generate text using LLM",
+        parameters: {
+          prompt: { type: "string", description: "Input prompt", required: true },
+          max_tokens: { type: "number", description: "Max tokens to generate", default: 1000 },
+          temperature: { type: "number", description: "Sampling temperature", default: 0.7 },
+        },
+        returns: "Generated text",
+      },
+      {
+        name: "create_embedding",
+        description: "Create vector embedding for text",
+        parameters: {
+          text: { type: "string", description: "Text to embed", required: true },
+          model: {
+            type: "string",
+            description: "Embedding model",
+            default: "text-embedding-3-small",
+          },
+        },
+        returns: "Vector embedding array",
+      },
+      {
+        name: "translate",
+        description: "Translate text between languages",
+        parameters: {
+          text: { type: "string", description: "Text to translate", required: true },
+          source: { type: "string", description: "Source language code", default: "en" },
+          target: { type: "string", description: "Target language code", required: true },
+        },
+        returns: "Translated text",
+      },
+    ],
+    rateLimit: { maxRequests: 100, windowMs: 60000 },
+  },
+];
+
+/**
+ * Register all internal servers
+ */
+export function registerInternalServers(): void {
+  for (const server of INTERNAL_SERVERS) {
+    serverRegistry.register(server);
+  }
+}
+
+/**
+ * Get list of internal server IDs
+ */
+export function getInternalServerIds(): string[] {
+  return INTERNAL_SERVERS.map((s) => s.id);
+}

package/src/types.ts

@@ -0,0 +1,118 @@
+import { z } from "zod";
+
+// ============================================
+// MCP Tool Definition
+// ============================================
+
+export const ToolParameterSchema = z.object({
+  type: z.enum(["string", "number", "boolean", "object", "array"]),
+  description: z.string().optional(),
+  required: z.boolean().optional(),
+  default: z.any().optional(),
+});
+
+export const ToolDefinitionSchema = z.object({
+  name: z.string(),
+  description: z.string(),
+  parameters: z.record(z.string(), ToolParameterSchema).optional(),
+  returns: z.string().optional(),
+});
+
+export type ToolParameter = z.infer<typeof ToolParameterSchema>;
+export type ToolDefinition = z.infer<typeof ToolDefinitionSchema>;
+
+// ============================================
+// MCP Request/Response
+// ============================================
+
+export interface MCPRequest {
+  id: string;
+  method: string;
+  params?: Record<string, unknown>;
+}
+
+export interface MCPResponse {
+  id: string;
+  result?: unknown;
+  error?: MCPError;
+}
+
+export interface MCPError {
+  code: number;
+  message: string;
+  data?: unknown;
+}
+
+// ============================================
+// MCP Context (with tenant info)
+// ============================================
+
+export interface MCPContext {
+  requestId: string;
+  tenantId?: string;
+  userId?: string;
+  plan?: string;
+  permissions?: string[];
+  metadata?: Record<string, unknown>;
+}
+
+// ============================================
+// Tool Execution
+// ============================================
+
+export interface ToolExecutionRequest {
+  tool: string;
+  arguments: Record<string, unknown>;
+  context: MCPContext;
+}
+
+export interface ToolExecutionResult {
+  success: boolean;
+  result?: unknown;
+  error?: string;
+  duration: number;
+  tokensUsed?: number;
+}
+
+// ============================================
+// MCP Server Registration
+// ============================================
+
+export interface MCPServerConfig {
+  id: string;
+  name: string;
+  description: string;
+  endpoint: string;
+  transport: "http" | "websocket" | "stdio";
+  tools: ToolDefinition[];
+  authentication?: {
+    type: "bearer" | "api-key" | "none";
+    headerName?: string;
+  };
+  rateLimit?: {
+    maxRequests: number;
+    windowMs: number;
+  };
+  // Tenant access control
+  allowedPlans?: string[]; // e.g., ["PRO", "ENTERPRISE"]
+  allowedTenants?: string[]; // specific tenant IDs
+}
+
+// ============================================
+// Smithery Integration
+// ============================================
+
+export interface SmitheryServerInfo {
+  qualifiedName: string;
+  displayName: string;
+  description: string;
+  homepage?: string;
+  useCount?: number;
+  isDeployed?: boolean;
+}
+
+export interface SmitheryConfig {
+  apiKey?: string;
+  baseUrl: string;
+  defaultServers?: string[]; // Pre-configured server qualified names
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts", "src/server/contextServer.ts"],
+  format: ["esm"],
+  dts: true,
+  clean: true,
+  target: "node18",
+  outDir: "dist",
+  minify: false,
+});