Kembali ke skill
multi-cli-mcp
oleh keiranhaax
AiderโBelum ada penilaian
Penilaian Anda
Ringkasan
A unified MCP server that wraps multiple CLI chat tools (qwen, opencode, aider) for Claude Code
Deskripsi
# Multi-CLI MCP Server
A unified MCP (Model Context Protocol) server that wraps multiple AI CLI chat tools (qwen, opencode, aider, codex, cursor) with stateful session management and robust process handling.
## Features
- ๐ **Unified Interface**: Single MCP server for multiple CLI tools
- ๐ฌ **Stateful Sessions**: Maintains conversation context across messages
- ๐๏ธ **Session Isolation**: Each session gets its own workspace
- ๐ง **Process Management**: Health checks, auto-restart, and graceful shutdown
- โก **Circuit Breaker**: Prevents cascade failures from repeated crashes
- โฑ๏ธ **TTL Cleanup**: Automatic cleanup of idle sessions (30 min default)
- ๐ก๏ธ **Input Sanitization**: Prevents injection attacks
- ๐ **Structured Logging**: Debug-friendly output
## Installation
```bash
cd /Users/keiranmini/multi-cli-mcp
npm install
npm run build
```
## Configuration
Set environment variables for API keys:
```bash
# For qwen
export QWEN_API_KEY="your-key"
export QWEN_MODEL="qwen3-coder-plus" # optional
# For opencode
export GROQ_API_KEY="your-key"
export OPENCODE_MODEL="groq/llama-3.3-70b-versatile" # optional
# For aider
export OPENAI_API_KEY="your-key"
export ANTHROPIC_API_KEY="your-key" # optional
export AIDER_MODEL="gpt-4o" # optional
# For codex
export CODEX_MODEL="gpt-5" # optional
# For cursor
export CURSOR_API_KEY="your-key" # or run: cursor-agent login
export CURSOR_MODEL="gpt-5" # optional
```
## Adding to Claude Code
Add to your Claude Code configuration:
```bash
claude mcp add multi-cli "node /Users/keiranmini/multi-cli-mcp/dist/index.js"
```
Or add directly to your MCP settings file:
```json
{
"mcpServers": {
"multi-cli": {
"command": "node",
"args": ["/Users/keiranmini/multi-cli-mcp/dist/index.js"],
"env": {
"QWEN_API_KEY": "your-key",
"GROQ_API_KEY": "your-key",
"OPENAI_API_KEY": "your-key",
"CURSOR_API_KEY": "your-key"
}
}
}
}
```
## Usage
Once installed, Claude Code will have access to two new tools:
### 1. Chat Tool
Send messages to CLI tools:
```typescript
// Simple message
chat({
tool: "qwen",
message: "What is the capital of France?"
})
// With session (maintains context)
chat({
tool: "opencode",
message: "Help me write a Python function",
sessionId: "session_abc123"
})
// With custom model
chat({
tool: "aider",
message: "Refactor this code",
model: "gpt-4o",
files: ["src/app.py"],
workingDirectory: "/path/to/project"
})
```
### 2. Session Management
Manage chat sessions:
```typescript
// Create a new session
session({
action: "create",
tool: "qwen",
workingDirectory: "/tmp/my-project" // optional
})
// List all sessions
session({
action: "list"
})
// Destroy a session
session({
action: "destroy",
sessionId: "session_abc123"
})
// Cleanup idle sessions
session({
action: "cleanup"
})
```
## Architecture
```
โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโ
โ Claude Code โโโโโโถโ Multi-CLI MCP Server โ
โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโโดโโโโโโโโโโโ
โ โ
โโโโโโโโโผโโโโโโโ โโโโโโโโโผโโโโโโโ
โSession Managerโ โProcess Managerโ
โโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโ
โ โ
โโโโโโโโโโโโผโโโโโโโโโโโ โ
โ โ โ โ
โโโโโโผโโโโ โโโโโผโโโโโ โโโโผโโโโโ โ
โ Qwen โ โOpenCodeโ โ Aider โ โ
โAdapter โ โAdapter โ โAdapterโ โ
โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโ โ
โ
โโโโโโโโโโโโผโโโโโโโโโโโ
โ CLI Processes โ
โ (qwen, opencode, โ
โ aider) โ
โโโโโโโโโโโโโโโโโโโโโโ
```
## Features in Detail
### Session Management
- Each session gets an isolated workspace in `/tmp/multi-cli-mcp/session_*`
- Sessions persist conversation state across messages
- Automatic TTL-based cleanup (30 minutes idle time)
- Maximum 10 concurrent sessions (configurable)
### Process Management
- Health checks every 30 seconds
- Automatic restart on crash (max 3 restarts/minute)
- Circuit breaker prevents cascade failures
- Graceful shutdown with SIGTERM, forced with SIGKILL
### Output Parsing
- Delimiter-based parsing for reliable output extraction
- Buffer management for large outputs
- ANSI escape code removal
- Tool-specific output cleaning
### Error Handling
- Input sanitization to prevent injection
- Timeout handling (30s default, 60s for aider)
- Comprehensive error messages
- Structured logging for debugging
## Development
```bash
# Run in development mode
npm run dev
# Build for production
npm run build
# Start production server
npm start
```
## Troubleshooting
### CLI Tool Not Found
Ensure the CLI tools are installed and accessible:
```bash
which qwen
which opencode
which aider
which codex
which cursor-agent
```
### API Key Issues
Check that environment variables are set:
```bash
echo $QWEN_API_KEY
echo $GROQ_API_KEY
echo $OPENAI_API_KEY
echo $CURSOR_API_KEY
```
### Cursor Authentication
Cursor-agent requires authentication via either:
1. Browser login: `cursor-agent login`
2. API key: Set `CURSOR_API_KEY` environment variable
### Session Issues
- Sessions auto-cleanup after 30 minutes of inactivity
- Maximum 10 concurrent sessions by default
- Check session list with `session({ action: "list" })`
## License
MITInstalasi
Pasang skill dari https://github.com/keiranhaax/multi-cli-mcpSkill ini belum dipublikasikan di registri ClawHub. Tempel prompt ke coding agent Anda โ Claude Code, Cursor, Codex โ dan skill-nya akan dipasang langsung dari repositori sumbernya.
Buka repositori