Add command executor MCP server

[steveluc]

Summary

This PR introduces a new MCP (Model Context Protocol) server that enables Claude Code to execute TypeAgent commands through natural language. The server bridges Claude Code and the TypeAgent dispatcher, enabling music playback, list management, calendar operations, and other TypeAgent capabilities.

Key Features

• WebSocket Connection: Connects Claude Code to TypeAgent dispatcher at ws://localhost:8999
• Automatic Reconnection: Monitors connection health and reconnects every 5 seconds if needed
• Lazy Connection: Server starts even if TypeAgent dispatcher isn't running yet
• Comprehensive Logging: All activity logged to temp files (/tmp/typeagent-mcp/) for debugging
• Clean Output: HTML image tags are stripped from responses for better readability in CLI

Natural Language Commands

The server translates natural language into TypeAgent actions:

• Music: "play bohemian rhapsody by queen", "my ear wants to hear thriller"
• Lists: "what's on my grocery list", "add milk to shopping list"
• Calendar: "schedule meeting tomorrow at 2pm" (when calendar agent is available)

Caching Behavior

The TypeAgent dispatcher includes intelligent caching that learns from command patterns:

• First use of a sentence structure: AI translation (~1-2s)
• Subsequent uses: Cached translation (~0.001s)
• Cache persists across different songs/items with same structure

Installation

Users add this to .mcp.json in the TypeAgent repo:

{
  "mcpServers": {
    "command-executor": {
      "command": "node",
      "args": ["packages/commandExecutor/dist/server.js"]
    }
  }
}

Files Added

• packages/commandExecutor/ - Complete MCP server package
• .mcp.json - Example MCP configuration
• README with installation and usage instructions
• Logging utilities and test client

Test Plan

• Play music with various sentence structures
• Manage lists (grocery, shopping)
• Verify caching behavior (0.001s for cached, 1-2s for new patterns)
• Test reconnection when TypeAgent server restarts
• Verify clean output formatting

🤖 Generated with Claude Code