Claude Command Runner
MCP server purpose-built for Warp Terminal. Swift, dual-consumer (Claude Desktop + Warp native agent panel), 39 tools. Warp integration via warp:// deeplinks, OSC 777 cli-agent events, and ~/.warp/launch_configurations/ profile sync. Includes shell s
What is Claude Command Runner?
Claude Command Runner is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server purpose-built for warp terminal. swift, dual-consumer (claude desktop + warp native agent panel), 39 tools. warp integration via warp:// deeplinks, osc 777 cli-agent events, and ~/.warp/lau...
MCP server purpose-built for Warp Terminal. Swift, dual-consumer (Claude Desktop + Warp native agent panel), 39 tools. Warp integration via warp:// deeplinks, OSC 777 cli-agent events, and ~/.warp/launch_configurations/ profile sync. Includes shell s
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server purpose-built for Warp Terminal. Swift, dual-cons
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx claude-command-runnerConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Claude Command Runner
Claude Command Runner is a native Swift MCP server purpose-built for macOS and Warp Terminal, exposing 40 tools that give AI assistants direct control over terminal operations, pipelines, SSH sessions, file watching, clipboard, workspace profiles, and Warp-specific deep links. It bridges Claude Desktop and the Warp native agent panel simultaneously, enabling sophisticated automation workflows like multi-step build pipelines with error handling, streaming long-running commands, and managing remote SSH connections — all coordinated by the AI without leaving the chat interface.
Prerequisites
- macOS (the server is written in Swift and requires Apple platform APIs)
- Xcode or Swift 6.0+ toolchain installed
- Warp Terminal (optional, required for Warp-specific tools like focus_warp_session and emit_warp_event)
- Claude Desktop or another MCP-compatible client
- Git to clone the repository
Clone the repository
Download the Claude Command Runner source code to your local machine.
git clone https://github.com/M-Pineapple/claude-command-runner.git
cd claude-command-runnerBuild the Swift binary
Run the provided build script which compiles the Swift source and places the binary in the expected location. Optionally set CCR_CODESIGN_IDENTITY to your Apple Developer certificate SHA-1 for reproducible signed builds.
./build.shVerify the build
Confirm the binary was produced successfully before configuring your MCP client.
./.build/release/claude-command-runner --versionConfigure Claude Desktop
Add the server to your Claude Desktop configuration file, pointing to the built binary. The server runs as a local stdio process.
{
"mcpServers": {
"claude-command-runner": {
"command": "/path/to/claude-command-runner/.build/release/claude-command-runner"
}
}
}Review and customize the config file
The server creates a config file at ~/.claude-command-runner/config.json on first run. Edit it to configure blocked commands for safety, notification preferences, SSH timeouts, and the maximum number of file watchers.
{
"terminal": { "preferred": "auto" },
"security": { "blockedCommands": ["rm -rf /", "sudo rm"] },
"history": { "maxEntries": 10000 },
"notifications": { "enabled": true },
"fileWatching": { "maxWatchers": 5 },
"ssh": { "defaultTimeout": 30 }
}Test with a basic command
After restarting Claude Desktop, ask it to run a simple command to confirm the MCP server is connected and working.
Claude Command Runner Examples
Client configuration
Configure Claude Desktop to launch the built Claude Command Runner Swift binary as a local MCP server.
{
"mcpServers": {
"claude-command-runner": {
"command": "/Users/yourname/claude-command-runner/.build/release/claude-command-runner"
}
}
}Prompts to try
Example prompts that take advantage of Claude Command Runner's 40 tools for terminal automation.
- "Run swift build and then swift test; stop if the build fails."
- "Watch the file ~/project/config.yaml for changes and notify me."
- "SSH into dev-server.example.com and run df -h to check disk usage."
- "Save the current project environment as a workspace profile called 'backend-dev'."
- "Copy the output of the last command to my clipboard."Troubleshooting Claude Command Runner
build.sh fails with 'no such module' Swift compiler errors
Ensure you have Xcode installed (not just the command-line tools) as the server may depend on macOS-specific frameworks. Run xcode-select --install and then open Xcode once to accept the license before rebuilding.
Warp-specific tools (focus_warp_session, emit_warp_event) do nothing
These tools require Warp Terminal to be installed and running. The OSC 777 cli-agent events and warp:// deeplinks are Warp-proprietary features. Using these tools with a standard terminal emulator like iTerm2 will have no effect.
A command I expect to work is blocked by the server
Check the blockedCommands array in ~/.claude-command-runner/config.json. Remove the command from that list or adjust the pattern if it was blocked by mistake, then restart Claude Desktop.
Frequently Asked Questions about Claude Command Runner
What is Claude Command Runner?
Claude Command Runner is a Model Context Protocol (MCP) server that mcp server purpose-built for warp terminal. swift, dual-consumer (claude desktop + warp native agent panel), 39 tools. warp integration via warp:// deeplinks, osc 777 cli-agent events, and ~/.warp/launch_configurations/ profile sync. includes shell s It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Claude Command Runner?
Follow the installation instructions on the Claude Command Runner GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Claude Command Runner?
Claude Command Runner works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Claude Command Runner free to use?
Yes, Claude Command Runner is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Claude Command Runner Alternatives — Similar Developer Tools Servers
Looking for alternatives to Claude Command Runner? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Claude Command Runner in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Claude Command Runner?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.