Talon

MCP (Model Context Protocol) server for the Talon accessibility framework. Surfaces important Talon information like logs and provides access to the Python REPL.

Installation

bun install

Usage

Run the MCP server:

bun run tools/mcp-server.ts

Or use the CLI flags:

bun run tools/mcp-server.ts --help
bun run tools/mcp-server.ts --version

MCP Tools

Tool	Description
talon_getLogs	Get Talon log entries with optional filtering by level or search term
talon_getStatus	Check if Talon is running
talon_repl	Execute Python code in Talon REPL
talon_getConfig	Get Talon configuration paths (home, logs, user scripts)

Claude Code Configuration

Add to your MCP config (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "talon-mcp": {
      "command": "bun",
      "args": ["run", "/path/to/talon_mcp/tools/mcp-server.ts"]
    }
  }
}

Development

bun test              # Run tests
bun run format        # Format code
bun run lint          # Lint code

License

MIT