pi-mcp-adapter 1.3.0 → 1.4.1

package/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.1] - 2026-01-19
+
+### Changed
+
+- Status bar shows server count instead of tool count ("MCP: 5 servers")
+
+## [1.4.0] - 2026-01-19
+
+### Changed
+
+- **Non-blocking startup** - Pi starts immediately, MCP servers connect in background. First MCP call waits only if init isn't done yet.
+
+### Fixed
+
+- Tool metadata now includes `inputSchema` after `/mcp reconnect` (was missing, breaking describe and error hints)
+
 ## [1.3.0] - 2026-01-19
 
 ### Changed

package/README.md

@@ -6,11 +6,11 @@ https://github.com/user-attachments/assets/4b7c66ff-e27e-4639-b195-22c3db406a5a
 
 ## Why This Exists
 
-Mario (Pi's creator) wrote about [why you might not need MCP](https://mariozechner.at/posts/2025-11-02-what-if-you-dont-need-mcp/). The core issue: MCP servers ship dozens of tools with verbose descriptions. Playwright MCP has 21 tools eating 13.7k tokens. Chrome DevTools MCP has 26 tools eating 18k tokens. Connect a few servers and you've burned 30-50k tokens before the conversation starts. That's context bloat, slower responses, higher costs, and confused agents drowning in tool options.
+Mario wrote about [why you might not need MCP](https://mariozechner.at/posts/2025-11-02-what-if-you-dont-need-mcp/). The problem: each MCP server dumps dozens of tools into your context. Playwright alone eats 13k tokens. Connect a few servers and you've burned half your context window before the conversation starts.
 
-His solution: skip MCP, write simple CLI tools.
+His take: skip MCP entirely, write simple CLI tools instead.
 
-But there's an active ecosystem of well-maintained MCP servers for databases, browsers, APIs, file systems, and more. This adapter lets you tap into that ecosystem without the context cost. One proxy tool (~200 tokens) instead of hundreds of individual tool definitions. The LLM discovers what it needs on-demand.
+But the MCP ecosystem has useful stuff - databases, browsers, APIs. This adapter gives you access without the bloat. One proxy tool (~200 tokens) instead of hundreds. The agent discovers what it needs on-demand.
 
 ## Install
 

package/index.ts

@@ -55,25 +55,34 @@ export default function mcpAdapter(pi: ExtensionAPI) {
   });
   
   pi.on("session_start", async (_event, ctx) => {
+    // Non-blocking init - Pi starts immediately, MCP connects in background
     initPromise = initializeMcp(pi, ctx);
-    state = await initPromise;
-    initPromise = null;
     
-    // Set up callback for auto-reconnect to update metadata
-    state.lifecycle.setReconnectCallback((serverName) => {
-      if (state) {
-        updateServerMetadata(state, serverName);
+    initPromise.then(s => {
+      state = s;
+      initPromise = null;
+      
+      // Set up callback for auto-reconnect to update metadata
+      s.lifecycle.setReconnectCallback((serverName) => {
+        if (state) {
+          updateServerMetadata(state, serverName);
+        }
+      });
+      
+      // Update status bar when ready
+      if (ctx.hasUI) {
+        const serverCount = s.registeredTools.size;
+        if (serverCount > 0) {
+          const label = serverCount === 1 ? "server" : "servers";
+          ctx.ui.setStatus("mcp", ctx.ui.theme.fg("accent", `MCP: ${serverCount} ${label}`));
+        } else {
+          ctx.ui.setStatus("mcp", "");
+        }
       }
+    }).catch(err => {
+      console.error("MCP initialization failed:", err);
+      initPromise = null;
     });
-    
-    if (ctx.hasUI) {
-      const totalTools = [...state.registeredTools.values()].flat().length;
-      if (totalTools > 0) {
-        ctx.ui.setStatus("mcp", ctx.ui.theme.fg("accent", `MCP: ${totalTools} tools`));
-      } else {
-        ctx.ui.setStatus("mcp", "");
-      }
-    }
   });
   
   pi.on("session_shutdown", async () => {
@@ -95,6 +104,15 @@ export default function mcpAdapter(pi: ExtensionAPI) {
   pi.registerCommand("mcp", {
     description: "Show MCP server status",
     handler: async (args, ctx) => {
+      // Wait for init if still in progress
+      if (!state && initPromise) {
+        try {
+          state = await initPromise;
+        } catch {
+          if (ctx.hasUI) ctx.ui.notify("MCP initialization failed", "error");
+          return;
+        }
+      }
       if (!state) {
         if (ctx.hasUI) ctx.ui.notify("MCP not initialized", "error");
         return;
@@ -128,6 +146,15 @@ export default function mcpAdapter(pi: ExtensionAPI) {
         return;
       }
       
+      // Wait for init if still in progress
+      if (!state && initPromise) {
+        try {
+          state = await initPromise;
+        } catch {
+          if (ctx.hasUI) ctx.ui.notify("MCP initialization failed", "error");
+          return;
+        }
+      }
       if (!state) {
         if (ctx.hasUI) ctx.ui.notify("MCP not initialized", "error");
         return;
@@ -173,6 +200,17 @@ Mode: tool (call) > describe > search > server (list) > nothing (status)`,
       includeSchemas?: boolean;
       server?: string;
     }) {
+      // Wait for init if still in progress
+      if (!state && initPromise) {
+        try {
+          state = await initPromise;
+        } catch {
+          return {
+            content: [{ type: "text", text: "MCP initialization failed" }],
+            details: { error: "init_failed" },
+          };
+        }
+      }
       if (!state) {
         return {
           content: [{ type: "text", text: "MCP not initialized" }],
@@ -827,11 +865,12 @@ async function reconnectServers(
       
       state.registeredTools.set(name, toolNames);
       
-      // Update tool metadata for searching
+      // Update tool metadata for searching (include inputSchema for describe/errors)
       const metadata: ToolMetadata[] = connection.tools.map(tool => ({
         name: formatToolName(tool.name, name, prefix),
         originalName: tool.name,
         description: tool.description ?? "",
+        inputSchema: tool.inputSchema,
       }));
       for (const resource of connection.resources) {
         if (definition.exposeResources !== false) {
@@ -863,11 +902,12 @@ async function reconnectServers(
     }
   }
   
-  // Update status bar with new tool count
+  // Update status bar with server count
   if (ctx.hasUI) {
-    const totalTools = [...state.registeredTools.values()].flat().length;
-    if (totalTools > 0) {
-      ctx.ui.setStatus("mcp", ctx.ui.theme.fg("accent", `MCP: ${totalTools} tools`));
+    const serverCount = state.registeredTools.size;
+    if (serverCount > 0) {
+      const label = serverCount === 1 ? "server" : "servers";
+      ctx.ui.setStatus("mcp", ctx.ui.theme.fg("accent", `MCP: ${serverCount} ${label}`));
     } else {
       ctx.ui.setStatus("mcp", "");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-mcp-adapter",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "MCP (Model Context Protocol) adapter extension for Pi coding agent",
   "type": "module",
   "license": "MIT",