@nebutra/mcp 0.1.2 → 0.1.4

package/src/server/contextServer.ts

@@ -1,211 +0,0 @@
-#!/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() {
-    const handlers = createContextServerHandlers(this.projectRoot);
-
-    this.server.setRequestHandler(ListResourcesRequestSchema, async () => handlers.listResources());
-
-    this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-      return handlers.readResource(request.params);
-    });
-  }
-
-  private setupToolHandlers() {
-    const handlers = createContextServerHandlers(this.projectRoot);
-
-    this.server.setRequestHandler(ListToolsRequestSchema, async () => handlers.listTools());
-
-    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
-      return handlers.callTool(request.params);
-    });
-  }
-
-  async run() {
-    const transport = new StdioServerTransport();
-    await this.server.connect(transport);
-  }
-}
-
-const RESOURCE_MAP = {
-  "file:///nebutra.config.json": {
-    relativePath: "nebutra.config.json",
-    name: "Nebutra Configuration",
-    mimeType: "application/json",
-    description:
-      "Global configurations for the Nebutra template including enabled features (auth, payments, i18n, db).",
-  },
-  "file:///prisma/schema.prisma": {
-    relativePath: "packages/platform/db/prisma/schema.prisma",
-    name: "Database Schema Overview",
-    mimeType: "text/plain",
-    description: "The core Prisma schema defining the database tables and relationships.",
-  },
-} as const;
-
-export function createContextServerHandlers(projectRoot: string) {
-  return {
-    async listResources() {
-      return {
-        resources: Object.entries(RESOURCE_MAP).map(([uri, resource]) => ({
-          uri,
-          name: resource.name,
-          mimeType: resource.mimeType,
-          description: resource.description,
-        })),
-      };
-    },
-
-    async readResource({ uri }: { uri: string }) {
-      const resource = RESOURCE_MAP[uri as keyof typeof RESOURCE_MAP];
-      if (!resource) {
-        throw new Error(`Resource not found: ${uri}`);
-      }
-
-      const filePath = path.join(projectRoot, resource.relativePath);
-      try {
-        const content = fs.readFileSync(filePath, "utf-8");
-        return {
-          contents: [
-            {
-              uri,
-              mimeType: resource.mimeType,
-              text: content,
-            },
-          ],
-        };
-      } catch {
-        throw new Error(`Failed to read the requested resource file at ${filePath}`);
-      }
-    },
-
-    async listTools() {
-      return {
-        tools: [
-          {
-            name: "get_project_structure",
-            description: "Returns a bounded app/package routing tree for the current project.",
-            inputSchema: {
-              type: "object",
-              properties: {},
-              required: [],
-            },
-          },
-        ],
-      };
-    },
-
-    async callTool({ name }: { name: string; arguments?: Record<string, unknown> | undefined }) {
-      if (name !== "get_project_structure") {
-        throw new Error(`Unknown tool: ${name}`);
-      }
-
-      try {
-        return {
-          content: [
-            {
-              type: "text",
-              text: getProjectStructure(projectRoot),
-            },
-          ],
-        };
-      } catch (error) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-            },
-          ],
-          isError: true,
-        };
-      }
-    },
-  };
-}
-
-function getProjectStructure(projectRoot: string): string {
-  const roots = ["apps", "packages", "backends"].filter((segment) =>
-    fs.existsSync(path.join(projectRoot, segment)),
-  );
-  if (roots.length === 0) return "No Nebutra workspace roots found.";
-
-  const entries: string[] = [];
-  for (const root of roots) {
-    walkProjectTree(path.join(projectRoot, root), root, entries, 4);
-  }
-  return entries.length > 0 ? entries.join("\n") : "No project entries found.";
-}
-
-function walkProjectTree(
-  absoluteDir: string,
-  relativeDir: string,
-  entries: string[],
-  depthRemaining: number,
-): void {
-  if (depthRemaining < 0 || entries.length >= 200) return;
-
-  entries.push(relativeDir);
-
-  for (const dirent of fs.readdirSync(absoluteDir, { withFileTypes: true })) {
-    if (!dirent.isDirectory()) continue;
-    if (dirent.name === "node_modules" || dirent.name.startsWith(".")) continue;
-    walkProjectTree(
-      path.join(absoluteDir, dirent.name),
-      path.join(relativeDir, dirent.name),
-      entries,
-      depthRemaining - 1,
-    );
-  }
-}
-
-// 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

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

package/src/server/internalServers.ts

@@ -1,70 +0,0 @@
-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

@@ -1,135 +0,0 @@
-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(),
-  allowedPlans: z.array(z.string()).optional(),
-  allowedTenants: z.array(z.string()).optional(),
-  requiredPermissions: z.array(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;
-}
-
-export interface MCPServerManifest {
-  name: string;
-  version: string;
-  scopes: string[];
-  homepage?: string;
-}
-
-// ============================================
-// MCP Server Registration
-// ============================================
-
-export interface MCPServerConfig {
-  id: string;
-  name: string;
-  description: string;
-  endpoint: string;
-  transport: "http" | "websocket" | "stdio" | "local";
-  manifest?: MCPServerManifest;
-  tools: ToolDefinition[];
-  handlers?: Record<string, MCPToolHandler>;
-  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
-}
-
-export type MCPToolHandler = (
-  args: Record<string, unknown>,
-  context: MCPContext,
-) => unknown | Promise<unknown>;
-
-// ============================================
-// 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

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

package/tsup.config.ts

@@ -1,17 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-  entry: ["src/index.ts", "src/cli.ts", "src/server/contextServer.ts"],
-  format: ["esm"],
-  dts: true,
-  clean: true,
-  target: "node18",
-  outDir: "dist",
-  minify: false,
-  external: [
-    "@modelcontextprotocol/sdk",
-    "@nebutra/errors",
-    "@nebutra/event-log",
-    "@nebutra/trace-store",
-  ],
-});