Claude Code MCP

Claude Code MCP - Agent Orchestration Platform

A sophisticatedFastMCP Python serverthat orchestrates multiple Claude Code agents across iTerm2 sessions, providing centralized management and inter-agent communication through task-based workflows.

- iTerm2 Tab-Based Sessions: No window complexity, pure tab management
- Persistent Agent State: Survives iTerm restarts with state recovery
- Codebase-Linked Sessions: Sessions tied to specific root filepaths
- Maximum Security Isolation: Process-level separation between agents
- Task-Based Inter-Agent Communication: ADDER+ workflow coordination
- System Prompt Injection: Automatic Agent_# naming and prompt prepending

Each agent operates with the comprehensiveADDER+ (Advanced Development, Documentation & Error Resolution)protocol, enabling:

- Autonomous Task Management: TODO.md-driven execution with real-time progress tracking
- Advanced Programming Synthesis: Design by Contract + defensive programming + type-driven development + property-based testing + functional programming patterns
- Systematic Error Resolution: Root Cause Analysis with automatic task generation
- Inter-Agent Coordination: Task-based communication through documentation files

- Process Isolation: Each Claude Code agent runs in separate process
- Session Boundaries: Agents cannot access other session codebases
- State Encryption: Persistent agent state encrypted at rest
- Audit Logging: All agent interactions logged for security analysis
- Permission Model: Role-based access control for agent operations

# Install dependencies uv sync # Start the MCP server python src/main.py

To use this Agent Orchestration Platform with Claude Desktop, you need to configure it as an MCP server in Claude's configuration file.

~/Library/Application Support/Claude/claude_desktop_config.json

%APPDATA%/Claude/claude_desktop_config.json

-

Open Configuration File: Navigate to the configuration file location above. Create the file if it doesn't exist.

Add Server Configuration: Add the following configuration to yourclaude_desktop_config.json:

{ "mcpServers": { "claude-code-mcp": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/Claude_Code_MCP", "run", "python", "src/main.py" ], "env": { "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src" } } } }

{ "mcpServers": { "claude-code-mcp": { "command": "python", "args": [ "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src/main.py" ], "env": { "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src" } } } }

{ "mcpServers": { "claude-code-mcp": { "command": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/.venv/bin/python", "args": [ "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src/main.py" ], "env": { "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src" } } } }

- Replace/ABSOLUTE/PATH/TO/Claude_Code_MCPwith the actual absolute path to your project directory
- On Windows, use backslashes in paths:C:\\path\ o\\Claude_Code_MCP
- Server Name: You can change"claude-code-mcp"to any name you prefer
- Virtual Environment: If using a virtual environment, adjust the Python path accordingly

{ "mcpServers": { "claude-code-mcp": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/Claude_Code_MCP", "run", "python", "src/main.py", "--security-level", "HIGH", "--max-agents", "16", "--max-sessions", "8" ], "env": { "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src" } } } }

{ "mcpServers": { "claude-code-mcp": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/Claude_Code_MCP", "run", "python", "src/main.py", "--log-dir", "/ABSOLUTE/PATH/TO/Claude_Code_MCP/logs" ], "env": { "PYTHONPATH": "/ABSOLUTE/PATH/TO/Claude_Code_MCP/src" } } } }

- Save Configuration: Save theclaude_desktop_config.jsonfile
- Restart Claude Desktop: Completely quit and restart Claude Desktop
- Check MCP Status: Look for MCP server indicators in the Claude Desktop interface:

- Hammer icon (🔨) indicating available tools
- Connector icon indicating MCP server connection

- Verify all paths are absolute (not relative)
- Check thatuvorpythonis in your system PATH
- Ensure the project directory exists and has correct permissions
- Review Claude Desktop logs at:

- macOS:~/Library/Logs/Claude/mcp.log
- Windows:%APPDATA%\Claude\logs\mcp.log

Test the server manually before configuring Claude Desktop:

# Navigate to project directory cd /path/to/Claude_Code_MCP # Test with UV uv run python src/main.py --help # Test with Python directly python src/main.py --help

- Permission Errors: Ensure Claude Desktop has permission to execute the Python interpreter
- Import Errors: VerifyPYTHONPATHis correctly set in the configuration
- Port Conflicts: If using HTTP transport, ensure the port (default 8000) is available

Once configured, Claude Desktop will have access to these agent orchestration tools:

- create_agent- Create new Claude Code agent instances
- delete_agent- Remove agents from the system
- create_session- Create sessions tied to specific codebases
- get_session_status- Get status of all agents in a session
- delete_session- Remove entire sessions and all agents
- send_message_to_agent- Send messages with ADDER+ protocol integration
- clear_agent_conversation- Close current iTerm tab for agent
- start_new_agent_conversation- Open new iTerm tab for agent
- Session Creation: Link sessions to specific codebases
- Agent Spawning: Create specialized agents with custom system prompts
- Task Coordination: Agents communicate through TODO.md and task files
- Status Monitoring: Real-time visibility into agent progress and health
- Session Management: Persistent state with recovery capabilities

- FastMCP Framework: High-performance MCP server implementation
- iTerm2 Python API: Advanced terminal session management
- Claude Code: AI agent process orchestration
- Asyncio Architecture: Event-driven concurrent agent management

This platform enables sophisticated AI development workflows with multiple specialized agents working collaboratively on complex codebases while maintaining strict security isolation and comprehensive audit trails.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Agent-native developer Q&A API with MCP + A2A endpoints for citations, job pickup, and answer submission.

MCP bridge that lets Claude Code delegate heavy tasks to the Antigravity CLI (agy) — purpose-built tools, model routing with fallback, session continuity, and output truncation to save Claude's context and tokens.

Embeds intelligent guidance into AI workflows to organize development and ensure quality.

Open-source AI coding stack — bundled MCP servers, agent runtime, and developer tooling for shipping AI-native dev tools.

Local agent workbench bundling OpenHands, Goose, Aider, and ashlrcode against one local LLM, with ashlr-plugin MCP servers pre-wired.

Async Parallel Antigravity for Codex & Claude Code

Run parallel, resumable, human-operable Antigravity CLI sessions from Codex, Claude Code, or any MCP-capable agent harness.

knowledge network for AI coding agents. Developers connect their agents to a shared pool of verified solutions — saving tokens, reducing debugging time, and getting better results. Solution authors earn when their work helps others.

Multi-LLM Design and Build Team. Confer and create with a team of LLMs.

An MCP server for initial app planning and creating a good starting point for an app.

An AI-powered server that facilitates feature discussions between developers and AI, acting as a lead developer to guide implementation and architectural decisions.