builderos-cli 2.0.2 → 2.0.4

package/PUBLISHED.md

@@ -3,9 +3,9 @@
 ## ✅ Package Information
 
 **Package name**: `builderos-cli`
-**Version**: `2.0.0`
+**Version**: `2.0.3`
 **Registry**: https://www.npmjs.com/package/builderos-cli
-**Published**: 2026-01-14
+**Published**: 2026-01-15
 **Maintainer**: audilu <khl0327@gmail.com>
 
 ## 📦 Installation
@@ -88,10 +88,43 @@ npx builderos-cli init --api-url=YOUR_BUILDEROS_URL
 ## 📊 Package Stats
 
 ```
-Size: 6.6 kB (tarball)
-Unpacked: 21.5 kB
-Dependencies: 0
-Files: 6
+Size: 8.7 kB (tarball)
+Unpacked: 28.9 kB
+Dependencies: 1 (@modelcontextprotocol/sdk)
+Files: 8
+```
+
+## 🆕 Version 2.0.3 Updates
+
+**Published**: 2026-01-15
+
+**Key Changes**:
+- ✅ Merged MCP server functionality into main CLI package
+- ✅ Added `builderos-cli mcp` subcommand
+- ✅ No longer requires separate `@builderos/mcp-client` package
+- ✅ Added `@modelcontextprotocol/sdk` dependency
+- ✅ Simplified architecture: one package for all functionality
+
+**What's New**:
+```bash
+# New MCP server command (used by .mcp.json)
+npx builderos-cli mcp
+```
+
+**Updated `.mcp.json` format**:
+```json
+{
+  "mcpServers": {
+    "builder-os": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "builderos-cli", "mcp"],
+      "env": {
+        "BUILDEROS_API_URL": "http://builder-os.test"
+      }
+    }
+  }
+}
 ```
 
 ## 🔄 Future Updates

package/index.js

@@ -9,6 +9,7 @@
  * Usage:
  *   npx builderos-cli init [options]
  *   npx builderos-cli update [options]
+ *   npx builderos-cli mcp          # Start MCP server
  *
  * Options:
  *   --api-url=<url>     BuilderOS API URL (default: http://builder-os.test)
@@ -19,12 +20,31 @@
  */
 
 import { mkdir, writeFile, readFile, access } from 'fs/promises';
-import { join } from 'path';
+import { join, dirname } from 'path';
 import { constants } from 'fs';
+import { fileURLToPath } from 'url';
+import { startMCPServer } from './mcp-server.js';
+
+// Get package version
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(await readFile(join(__dirname, 'package.json'), 'utf-8'));
+const VERSION = packageJson.version;
 
 // Parse command line arguments
 const args = process.argv.slice(2);
 
+// Check for MCP server command first
+const command = args[0];
+if (command === 'mcp') {
+  // Start MCP server (this will run indefinitely)
+  await startMCPServer().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+  });
+  // MCP server is now running, this code won't be reached
+}
+
 // Default options
 const options = {
   apiUrl: process.env.BUILDEROS_API_URL || 'http://builder-os.test',
@@ -35,7 +55,6 @@ const options = {
 };
 
 // Check if first arg is help or no command
-const command = args[0];
 if (!command || command === '--help' || command === '-h') {
   options.help = true;
 }
@@ -58,15 +77,17 @@ for (const arg of args) {
 // Show help
 if (options.help) {
   console.log(`
-BuilderOS CLI v2.0.0
+BuilderOS CLI v${VERSION}
 
 Usage:
   npx builderos-cli init [options]
   npx builderos-cli update [options]
+  npx builderos-cli mcp
 
 Commands:
   init      Initialize BuilderOS in current project
   update    Update skills from BuilderOS API
+  mcp       Start MCP server (used by Claude Code)
 
 Options:
   --api-url=<url>     BuilderOS API URL (default: http://builder-os.test)
@@ -87,6 +108,9 @@ Examples:
 
   # Force reinstall
   npx builderos-cli init --force
+
+  # Start MCP server (automatically used by .mcp.json)
+  npx builderos-cli mcp
 `);
   process.exit(0);
 }
@@ -145,14 +169,13 @@ async function installMCP() {
     }
   }
 
-  // Always use remote mode (npx @builderos/mcp-client)
-  // This CLI is meant to be standalone, not requiring local BuilderOS code
+  // Use builderos-cli mcp command as MCP server
   const mcpConfig = {
     mcpServers: {
       'builder-os': {
         type: 'stdio',
         command: 'npx',
-        args: ['-y', '@builderos/mcp-client'],
+        args: ['-y', 'builderos-cli', 'mcp'],
         env: {
           BUILDEROS_API_URL: options.apiUrl,
         },
@@ -237,10 +260,10 @@ async function createMarker() {
 
   const marker = {
     initialized: true,
-    version: '2.0.0',
+    version: VERSION,
     timestamp: new Date().toISOString(),
     architecture: 'api-based',
-    cli_version: '2.0.0',
+    cli_version: VERSION,
   };
 
   await writeFile('.builderos', JSON.stringify(marker, null, 2) + '\n');
@@ -296,7 +319,7 @@ async function updateGitignore() {
 // Main execution
 async function main() {
   console.log('==========================================');
-  console.log('  BuilderOS CLI v2.0.0');
+  console.log(`  BuilderOS CLI v${VERSION}`);
   console.log('==========================================');
   console.log('');
   console.log(`Command: ${command}`);

package/mcp-server.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+
+/**
+ * BuilderOS MCP Server
+ *
+ * MCP server that connects to BuilderOS HTTP API.
+ * Used by Claude Code to access BuilderOS tools.
+ */
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+
+// Get API URL from environment variable
+const API_URL = process.env.BUILDEROS_API_URL || 'http://builder-os.test';
+
+/**
+ * Fetch tools from BuilderOS API
+ */
+async function fetchTools() {
+  try {
+    // Only set Host header if API URL is not builder-os.test
+    const headers = {};
+    if (!API_URL.includes('builder-os.test')) {
+      headers['Host'] = 'builder-os.test';
+    }
+
+    const response = await fetch(`${API_URL}/api/mcp/tools`, { headers });
+
+    if (!response.ok) {
+      throw new Error(`Failed to fetch tools: ${response.statusText}`);
+    }
+
+    const data = await response.json();
+    return data.tools || [];
+  } catch (error) {
+    console.error('Error fetching tools:', error);
+    return [];
+  }
+}
+
+/**
+ * Execute tool via BuilderOS API
+ */
+async function executeTool(toolName, args) {
+  try {
+    // Only set Host header if API URL is not builder-os.test
+    const headers = {
+      'Content-Type': 'application/json',
+    };
+    if (!API_URL.includes('builder-os.test')) {
+      headers['Host'] = 'builder-os.test';
+    }
+
+    const response = await fetch(`${API_URL}/api/mcp/execute`, {
+      method: 'POST',
+      headers,
+      body: JSON.stringify({
+        tool: toolName,
+        arguments: args
+      })
+    });
+
+    if (!response.ok) {
+      throw new Error(`Failed to execute tool: ${response.statusText}`);
+    }
+
+    const data = await response.json();
+    return data;
+  } catch (error) {
+    console.error('Error executing tool:', error);
+    throw error;
+  }
+}
+
+/**
+ * Start MCP server
+ */
+export async function startMCPServer() {
+  const server = new Server(
+    {
+      name: 'builderos-cli-mcp',
+      version: '2.0.3',
+    },
+    {
+      capabilities: {
+        tools: {},
+      },
+    }
+  );
+
+  // List available tools
+  server.setRequestHandler(ListToolsRequestSchema, async () => {
+    const tools = await fetchTools();
+    return { tools };
+  });
+
+  // Execute tool
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+
+    try {
+      const result = await executeTool(name, args || {});
+
+      return {
+        content: [
+          {
+            type: 'text',
+            text: JSON.stringify(result, null, 2),
+          },
+        ],
+      };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `Error: ${error.message}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  });
+
+  // Start server
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+
+  console.error('BuilderOS MCP Server started');
+  console.error(`Connected to: ${API_URL}`);
+}
+
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  startMCPServer().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "builderos-cli",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "BuilderOS CLI - Initialize BuilderOS in any project without requiring local code",
   "type": "module",
   "main": "index.js",
@@ -26,5 +26,8 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/builderos/builderos"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4"
   }
 }