概要
Quick Start Installation uv add circus-mcp Basic Usage
uv run circus-mcp start-daemon
uv run circus-mcp add webapp "python app.py" uv run circus-mcp start webapp
uv run circus-mcp overview
uv run circus-mcp logs webapp That's it! Your process is now managed by Circus MCP.
Key Features 🚀 Process Management Made Easy
uv run circus-mcp add api "uvicorn app:api" --numprocesses 4 --working-dir /app
uv run circus-mcp ensure-started api
uv run circus-mcp start-all uv run circus-mcp restart-all 📊 Comprehensive Monitoring
uv run circus-mcp overview
uv run circus-mcp status-all
uv run circus-mcp tail api uv run circus-mcp logs-all 🤖 AI Agent Integration Circus MCP includes built-in MCP protocol support, allowing AI agents to manage your processes:
uv run circus-mcp mcp Configure in your AI agent using the recommended stdio transport:
{ "mcpServers": { "circus-mcp": { "command": "uv", "args": ["run", "circus-mcp", "mcp"] } } } Note: This tool is designed for local development environments using MCP's stdio transport method as specified in the MCP documentation. This approach provides secure, direct communication between AI agents and the process manager.
Common Use Cases Web Application Management
uv run circus-mcp add webapp "gunicorn app:application" --numprocesses 4 uv run circus-mcp add worker "celery worker -A app" --numprocesses 2 uv run circus-mcp ensure-started all Development Environment
uv run circus-mcp add frontend "npm run dev" --working-dir /app/frontend uv run circus-mcp add backend "python manage.py runserver" --working-dir /app/backend uv run circus-mcp add redis "redis-server" uv run circus-mcp start-all Microservices
uv run circus-mcp add auth-service "python auth_service.py" uv run circus-mcp add user-service "python user_service.py" uv run circus-mcp add notification-service "python notification_service.py" uv run circus-mcp ensure-started all Why Circus MCP? vs. Docker Compose Lighter: No containers needed, just process management Faster: Direct process execution, no container overhead Simpler: One command to rule them all vs. systemd User-friendly: Simple commands instead of unit files Cross-platform: Works on any system with Python AI-ready: Built-in MCP support for automation vs. PM2 Python-native: Perfect for Python applications AI integration: MCP protocol support out of the box Comprehensive: Process + log management in one tool Advanced Features Intelligent State Management
uv run circus-mcp ensure-started webapp # Only starts if not running uv run circus-mcp ensure-stopped worker # Only stops if running Bulk Operations
uv run circus-mcp start-all # Start everything uv run circus-mcp stop-all # Stop everything uv run circus-mcp restart-all # Restart everything uv run circus-mcp logs-all # See all logs Log Management
uv run circus-mcp logs webapp --lines 100 --stream stderr uv run circus-mcp tail webapp --stream stdout
uv run circus-mcp logs-all Installation & Setup System Requirements Python 3.10 or higher Any operating system (Linux, macOS, Windows) Installation Options
uv add circus-mcp
pip install circus-mcp
git clone https://github.com/aether-platform/circus-mcp.git cd circus-mcp uv sync Verify Installation uv run circus-mcp --help uv run circus-mcp daemon-status Configuration Circus MCP works out of the box with sensible defaults. For advanced usage:
Custom Circus Configuration
uv run circus-mcp start-daemon -c /path/to/your/circus.ini Process Configuration
uv run circus-mcp add myapp "python app.py"
--numprocesses 4
--working-dir /app
Getting Help
Documentation
Development Guide - For contributors and advanced usage
API Reference - Complete command and API documentation
Support
GitHub Issues: Report bugs or request features
Discussions: Join the community
Releases: Latest releases and changelogs
Quick Command Reference
uv run circus-mcp start-daemon uv run circus-mcp stop-daemon uv run circus-mcp daemon-status
uv run circus-mcp add uv run circus-mcp start/stop/restart uv run circus-mcp ensure-started/ensure-stopped
uv run circus-mcp overview uv run circus-mcp status-all uv run circus-mcp logs
uv run circus-mcp mcp Examples Repository Check out our examples repository for real-world usage patterns:
Django + Celery setup FastAPI microservices React + Node.js development stack Machine learning pipeline management License MIT License - see LICENSE for details.
About the Author AetherPlatform - Building the future of cloud-native development tools
GitHub: @aether-platform Project Website: AetherPlatform Contact: [email protected] Our Mission We develop tools that enhance developer productivity through AI integration and modern cloud-native technologies. CircusMCP is part of our broader ecosystem of development tools designed to streamline the software development lifecycle.
Acknowledgments We extend our heartfelt gratitude to the Circus development team for creating such a robust and reliable process management foundation. Their excellent work made this project possible. Circus MCP builds upon their solid architecture to bring modern AI agent integration to process management.
Related Projects Circus - The underlying process manager (Thank you to the Circus team!) Model Context Protocol - AI agent communication standard AetherPlatform - Cloud-native development tools Made with ❤️ by AetherPlatform
Circus MCP: Simple process management, powerful automation.