{"id":"1abbc103-d4cb-46b0-ad4d-26d131345bff","slug":"claudecode-mcp-async","kind":"mcp","name":"claudecode-mcp-async","summary":"A mcp server that enables Claude Code to spawn child Claude Code sessions for parallel task execution.","owner":"jeanchristophe13v","repoUrl":"https://github.com/jeanchristophe13v/claudecode-mcp-async","license":"MIT","licenseTier":"permissive","trust":"community","stars":6,"match":null,"fewStars":false,"format":"mcp","createdAt":"2025-10-29T04:00:25.000Z","addedAt":"2026-10-21T16:10:13.316Z","logoUrl":"https://avatars.githubusercontent.com/u/161140413?u=f56e5603cfa96b2d9639ec85239788ddb1889d1b&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["developer-tools","productivity","cloud-infra"],"tags":[],"runtime":"python","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-25T21:18:08.523Z","sample":false,"url":"https://conduits.dev/tools/claudecode-mcp-async","language":"Python","transports":["stdio"],"install":{"pypi":"claudecode-mcp-async"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# Claude Code MCP Async Server\n\n**Asynchronous MCP wrapper for Claude Code CLI**\n\nEnable Claude Code to spawn child Claude Code sessions for parallel task execution.\n\n## Features\n\n- ✅ **Async execution** - Start tasks in background, continue working\n- ✅ **Multi-instance parallelism** - Run multiple Claude Code sessions simultaneously\n- ✅ **Automatic cleanup** - No zombie processes\n- ✅ **Zero config** - Works out of the box\n\n## Quick Start\n\n### 🚀 Install with UVX\n\nZero configuration - just run:\n\n```bash\nuvx claudecode-mcp-async\n```\n\n### Configure Claude Code\n\nAdd to your `~/.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"claude-code-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"claudecode-mcp-async\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n### Restart Claude Code\n\nReload or restart Claude Code to load the MCP server.\n\n## Usage Examples\n\n### 🚀 Async Execution (Game Changer!)\n\nStart a long task and continue working immediately:\n\n**You:**\n> Please analyze the entire project code and generate a comprehensive technical report\n\n**Claude:**\nI'll analyze your entire project and generate a technical report. This is a large task, so I'll start it asynchronously...\n\n✅ **Task Started** (Task ID: abc12345)\nYou can continue working on other things while it runs in the background!\n\n**You:** (Continue working immediately)\n> While the report is generating, help me write some unit tests\n\n**Claude:**\nSure! Let me write those unit tests for you...\n\n**You:** (A few minutes later)\n> Can you check if the report task is finished?\n\n**Claude:**\n✅ **Report Complete!**\n\n[View Detailed Technical Report]\n- Project structure analysis\n- Code quality assessment\n- Performance optimization recommendations\n- Security audit results\n\n### ⚡ Parallel Execution\n\nRun multiple tasks simultaneously:\n\n**You:**\n> I need to do three things at once:\n> 1. Generate unit tests for utils.py\n> 2. Refactor database.py to use async/await\n> 3. Add type hints to all functions in api.py\n\n**Claude:**\nI'll start all three tasks in parallel!\n\n🔄 **Task 1 Started** (Task ID: task1) - Generating unit tests\n🔄 **Task 2 Started** (Task ID: task2) - Refactoring database code\n🔄 **Task 3 Started** (Task ID: task3) - Adding type hints\n\nAll tasks are running in parallel...\n\n**You:** (Later)\n> Are all three tasks finished?\n\n**Claude:**\n✅ **All Complete!**\n\n- ✅ Task 1: Unit tests for utils.py generated\n- ✅ Task 2: database.py refactored to async mode\n- ✅ Task 3: Type hints added to api.py functions\n\n### 🎯 Quick Sync Tasks\n\nFor simple immediate tasks:\n\n**You:**\n> Write a Python function to validate email addresses\n\n**Claude:**\n```python\nimport re\n\ndef validate_email(email):\n    pattern = r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$'\n    return re.match(pattern, email) is not None\n\n# Usage examples\nprint(validate_email(\"user@example.com\"))  # True\nprint(validate_email(\"invalid-email\"))    # False\n```\n\n✅ **Task Complete!**\n\n## Why Async?\n\n**Problem:** Claude Code blocks the parent session while running.\n\n**Solution:** This MCP server spawns child Claude Code processes that run in the background.\n\n**Benefits:**\n- 🚀 Start a task and continue working immediately\n- ⚡ Run multiple tasks in parallel\n- 🎯 No blocking, no waiting\n- 🧹 Automatic process cleanup\n\n## Troubleshooting\n\n**Server not showing up?**\n- Use absolute path in config\n- Run: `chmod +x claudecode_mcp_async_server.py`\n- Restart Claude Code\n\n**Task stuck in \"running\"?**\n- Wait a moment, large tasks take time\n- Check: `ls -la /tmp/claude_code_tasks/`\n- View logs: `tail -f /tmp/claude_code_mcp_debug.log`\n\n## Requirements\n\n- Python 3.6+\n- Claude Code CLI installed\n\n## License\n\nMIT License\n\n---\n\n**Questions?** Open an issue on GitHub.\n\n"}