secondbrainos-mcp-server 1.0.5 → 1.0.8

package/bin/cli.js

@@ -116,6 +116,19 @@ function getNodeModulesPath() {
   }
 }
 
+/**
+ * Read existing Claude Desktop configuration
+ */
+async function readExistingConfig(configPath) {
+  try {
+    const configData = await fs.readFile(configPath, 'utf8');
+    return JSON.parse(configData);
+  } catch (error) {
+    // If file doesn't exist or is invalid JSON, return empty config
+    return {};
+  }
+}
+
 async function main() {
   try {
     // Get command line arguments
@@ -208,25 +221,39 @@ async function main() {
     // Find Node.js executable
     const nodePath = await findNodeExecutable();
     
-    // Create the Claude Desktop configuration
-    const configContent = {
-      mcpServers: {
-        secondbrainos: {
-          command: nodePath,
-          args: [serverPath],
-          env: {
-            USER_ID,
-            USER_SECRET,
-            API_BASE_URL: 'https://api.secondbrainos.com',
-            NODE_PATH: getNodeModulesPath()
-          }
-        }
+    // Read existing configuration
+    const existingConfig = await readExistingConfig(claudeConfigFile);
+    
+    // Ensure mcpServers object exists
+    if (!existingConfig.mcpServers) {
+      existingConfig.mcpServers = {};
+    }
+    
+    // Check if secondbrainos already exists
+    const hadExistingSecondBrainOS = !!existingConfig.mcpServers.secondbrainos;
+    
+    // Add or update the secondbrainos server configuration
+    existingConfig.mcpServers.secondbrainos = {
+      command: nodePath,
+      args: [serverPath],
+      env: {
+        USER_ID,
+        USER_SECRET,
+        API_BASE_URL: 'https://api.secondbrainos.com',
+        NODE_PATH: getNodeModulesPath()
       }
     };
     
     try {
-      await fs.writeFile(claudeConfigFile, JSON.stringify(configContent, null, 2));
-      console.log(`Configuration file created at: ${claudeConfigFile}`);
+      // Write the updated configuration back
+      await fs.writeFile(claudeConfigFile, JSON.stringify(existingConfig, null, 2));
+      console.log(`Configuration file ${hadExistingSecondBrainOS ? 'updated' : 'created'} at: ${claudeConfigFile}`);
+      
+      // Show summary of configured servers
+      const serverCount = Object.keys(existingConfig.mcpServers).length;
+      console.log(`\nTotal MCP servers configured: ${serverCount}`);
+      console.log('Configured servers:', Object.keys(existingConfig.mcpServers).join(', '));
+      
     } catch (error) {
       console.error('Error writing configuration file:', error);
       process.exit(1);

package/build/index.js

@@ -22,6 +22,14 @@ class SecondBrainOSServer {
             model: "chatgpt",
             document
         });
+        // Create a map of operationId to function for easier lookup
+        this.functionMap = new Map();
+        this.application.functions.forEach(func => {
+            const operation = func.operation();
+            if (operation.operationId) {
+                this.functionMap.set(operation.operationId, func);
+            }
+        });
         this.server = new Server({
             name: "secondbrainos-server",
             version: "1.0.0"
@@ -59,19 +67,38 @@ class SecondBrainOSServer {
                     }]
             };
         });
-        // List available tools - now using @samchon/openapi functions
+        // List available tools - now using operationId as the tool name
         this.server.setRequestHandler(ListToolsRequestSchema, async () => {
-            return {
-                tools: this.application.functions.map(func => ({
-                    name: func.name,
-                    description: func.description || func.name,
+            const tools = [];
+            // Iterate through the function map to get tools with proper names
+            for (const [operationId, func] of this.functionMap) {
+                tools.push({
+                    name: operationId,
+                    description: func.description || operationId,
                     inputSchema: func.parameters // Convert to MCP format
-                }))
-            };
+                });
+            }
+            // Also include functions without operationId (fallback)
+            this.application.functions.forEach(func => {
+                const operation = func.operation();
+                if (!operation.operationId) {
+                    tools.push({
+                        name: func.name,
+                        description: func.description || func.name,
+                        inputSchema: func.parameters
+                    });
+                }
+            });
+            return { tools };
         });
-        // Handle tool calls
+        // Handle tool calls - now supporting both operationId and original names
         this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
-            const func = this.application.functions.find(f => f.name === request.params.name);
+            // First try to find by operationId
+            let func = this.functionMap.get(request.params.name);
+            // If not found, try the original function name
+            if (!func) {
+                func = this.application.functions.find(f => f.name === request.params.name);
+            }
             if (!func) {
                 throw new McpError(ErrorCode.MethodNotFound, `Unknown function: ${request.params.name}`);
             }

package/build/test-mcp-conversion.js

@@ -0,0 +1,135 @@
+import { OpenApi, HttpLlm } from "@samchon/openapi";
+import axios from "axios";
+import dotenv from "dotenv";
+import fs from "fs/promises";
+import path from "path";
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+// Get __dirname equivalent for ES modules
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Load environment variables
+dotenv.config();
+// Function to fetch the schema from the API
+async function fetchSchema() {
+    const userId = process.env.USER_ID;
+    if (!userId) {
+        throw new Error("USER_ID environment variable is required");
+    }
+    console.log("Fetching schema for user:", userId);
+    try {
+        const response = await axios.post('https://us-central1-second-brain-os.cloudfunctions.net/generate-open-api-schema', { user_id: userId }, {
+            headers: {
+                'Content-Type': 'application/json'
+            }
+        });
+        return response.data;
+    }
+    catch (error) {
+        console.error('Failed to fetch schema:', error);
+        throw new Error('Failed to fetch API schema');
+    }
+}
+async function testMCPConversion() {
+    try {
+        console.log("=== MCP Conversion Test ===\n");
+        // Step 1: Fetch the original schema
+        console.log("1. Fetching OpenAPI schema...");
+        const originalSchema = await fetchSchema();
+        console.log("✓ Schema fetched successfully");
+        console.log(`  - Title: ${originalSchema.info?.title}`);
+        console.log(`  - Version: ${originalSchema.info?.version}`);
+        console.log(`  - Number of paths: ${Object.keys(originalSchema.paths || {}).length}\n`);
+        // Save original schema for reference
+        await fs.writeFile(path.join(__dirname, '../output/original-schema.json'), JSON.stringify(originalSchema, null, 2));
+        console.log("✓ Original schema saved to output/original-schema.json\n");
+        // Step 2: Convert using OpenApi
+        console.log("2. Converting schema using @samchon/openapi...");
+        const document = OpenApi.convert(originalSchema);
+        console.log("✓ Schema converted to OpenApi format\n");
+        // Step 3: Create LLM application
+        console.log("3. Creating LLM application...");
+        const application = HttpLlm.application({
+            model: "chatgpt",
+            document
+        });
+        console.log("✓ LLM application created");
+        console.log(`  - Number of functions: ${application.functions.length}\n`);
+        // Step 4: Create MCP-compatible tools
+        console.log("4. Converting to MCP tool format...");
+        const mcpTools = [];
+        const functionMap = new Map();
+        application.functions.forEach(func => {
+            const operation = func.operation();
+            const operationId = operation.operationId || func.name;
+            functionMap.set(operationId, func);
+            const mcpTool = {
+                name: operationId,
+                description: func.description || operationId,
+                inputSchema: func.parameters
+            };
+            mcpTools.push(mcpTool);
+        });
+        console.log(`✓ Converted ${mcpTools.length} tools to MCP format\n`);
+        // Step 5: Save the results
+        console.log("5. Saving conversion results...");
+        // Create output directory if it doesn't exist
+        await fs.mkdir(path.join(__dirname, '../output'), { recursive: true });
+        // Save MCP tools
+        await fs.writeFile(path.join(__dirname, '../output/mcp-tools.json'), JSON.stringify(mcpTools, null, 2));
+        console.log("✓ MCP tools saved to output/mcp-tools.json");
+        // Save function details
+        const functionDetails = application.functions.map(func => {
+            const operation = func.operation();
+            // Extract method and path from the route property if available
+            let method;
+            let path;
+            // The operation might have these properties in different ways depending on the OpenAPI version
+            // Let's check the actual structure
+            const route = operation.route;
+            if (route) {
+                method = route.method;
+                path = route.path;
+            }
+            return {
+                name: func.name,
+                operationId: operation.operationId,
+                method,
+                path,
+                description: func.description,
+                parameters: func.parameters,
+                operation: {
+                    summary: operation.summary,
+                    description: operation.description,
+                    tags: operation.tags
+                }
+            };
+        });
+        await fs.writeFile(path.join(__dirname, '../output/function-details.json'), JSON.stringify(functionDetails, null, 2));
+        console.log("✓ Function details saved to output/function-details.json\n");
+        // Step 6: Display summary
+        console.log("=== Conversion Summary ===");
+        console.log(`Total tools converted: ${mcpTools.length}`);
+        console.log("\nSample tools:");
+        mcpTools.slice(0, 5).forEach(tool => {
+            console.log(`  - ${tool.name}: ${tool.description}`);
+        });
+        if (mcpTools.length > 5) {
+            console.log(`  ... and ${mcpTools.length - 5} more`);
+        }
+        console.log("\n✓ Test completed successfully!");
+        console.log("\nCheck the 'output' directory for:");
+        console.log("  - original-schema.json: The raw OpenAPI schema from the API");
+        console.log("  - mcp-tools.json: Tools in MCP format");
+        console.log("  - function-details.json: Detailed function information");
+    }
+    catch (error) {
+        console.error("\n❌ Test failed:", error);
+        if (error instanceof Error) {
+            console.error("Error details:", error.message);
+        }
+        process.exit(1);
+    }
+}
+// Run the test
+testMCPConversion().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "secondbrainos-mcp-server",
-  "version": "1.0.5",
+  "version": "1.0.8",
   "description": "Second Brain OS MCP Server for Claude Desktop",
   "type": "module",
   "main": "build/index.js",
@@ -18,7 +18,7 @@
     "build": "tsc",
     "dev": "tsx src/index.ts",
     "start": "node build/index.js",
-    "test-conversion": "tsx src/test-conversion.ts",
+    "test-conversion": "tsx src/test-mcp-conversion.ts",
     "prepublishOnly": "npm run build",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
@@ -47,4 +47,4 @@
   "engines": {
     "node": ">=16.0.0"
   }
-}
+}

package/build/test-conversion.js

@@ -1,81 +0,0 @@
-import { OpenApi, HttpLlm } from "@samchon/openapi";
-import axios from "axios";
-import dotenv from "dotenv";
-dotenv.config();
-async function testSchemaConversion() {
-    const userId = process.env.USER_ID;
-    const userSecret = process.env.USER_SECRET;
-    if (!userId || !userSecret) {
-        console.error("❌ USER_ID and USER_SECRET environment variables are required");
-        console.error("Create a .env file with:");
-        console.error("USER_ID=your_user_id");
-        console.error("USER_SECRET=your_user_secret");
-        process.exit(1);
-    }
-    console.log("🔄 Fetching OpenAPI schema from Second Brain OS...");
-    try {
-        // Fetch the schema
-        const response = await axios.post('https://us-central1-second-brain-os.cloudfunctions.net/generate-open-api-schema', { user_id: userId }, {
-            headers: {
-                'Content-Type': 'application/json'
-            }
-        });
-        const openApiSchema = response.data;
-        console.log("✅ Schema fetched successfully!");
-        console.log(`📋 API Title: ${openApiSchema.info?.title || 'Unknown'}`);
-        console.log(`📋 API Version: ${openApiSchema.info?.version || 'Unknown'}`);
-        // Convert to emended OpenAPI document
-        console.log("\n🔄 Converting to emended OpenAPI format...");
-        const document = OpenApi.convert(openApiSchema);
-        console.log("✅ Conversion successful!");
-        // Create LLM application
-        console.log("\n🔄 Creating LLM function calling application...");
-        const application = HttpLlm.application({
-            model: "chatgpt",
-            document
-        });
-        console.log("✅ LLM application created!");
-        // Display the converted functions
-        console.log(`\n📊 Total functions available: ${application.functions.length}`);
-        console.log(`⚠️  Errors during conversion: ${application.errors.length}`);
-        if (application.errors.length > 0) {
-            console.log("\n❌ Conversion errors:");
-            application.errors.forEach((error, index) => {
-                console.log(`  ${index + 1}. ${error.method.toUpperCase()} ${error.path}`);
-                error.messages.forEach(msg => console.log(`     - ${msg}`));
-            });
-        }
-        console.log("\n🔧 Available MCP Tools:");
-        console.log("=".repeat(80));
-        application.functions.slice(0, 10).forEach((func, index) => {
-            console.log(`\n${index + 1}. ${func.name}`);
-            console.log(`   Method: ${func.method.toUpperCase()}`);
-            console.log(`   Path: ${func.path}`);
-            console.log(`   Description: ${func.description?.split('\n')[0] || 'No description'}`);
-            console.log(`   Parameters Schema: ${JSON.stringify(func.parameters).substring(0, 100)}...`);
-        });
-        if (application.functions.length > 10) {
-            console.log(`\n... and ${application.functions.length - 10} more functions`);
-        }
-        // Show a sample of how it would look as MCP tools
-        console.log("\n\n🎯 Sample MCP Tool Format:");
-        console.log("=".repeat(80));
-        const sampleFunc = application.functions[0];
-        if (sampleFunc) {
-            const mcpTool = {
-                name: sampleFunc.name,
-                description: sampleFunc.description || sampleFunc.name,
-                inputSchema: sampleFunc.parameters
-            };
-            console.log(JSON.stringify(mcpTool, null, 2));
-        }
-    }
-    catch (error) {
-        console.error("❌ Error:", error instanceof Error ? error.message : error);
-        if (axios.isAxiosError(error) && error.response) {
-            console.error("Response data:", error.response.data);
-        }
-    }
-}
-// Run the test
-testSchemaConversion();