
xiaolai/claude-octopus
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Один мозг, много рук — порождают несколько специализированных агентов кода Клода в качестве MCP-серверов
Обзор
Сервер MCP, который заворачивает SDK Claude Agent, позволяя запускать несколько специализированных агентов Claude Code — каждый со своей собственной моделью, инструментами, системной подсказкой и личностью — от любого клиента MCP. Код Клода очень мощный. Но один случай делает все одинаково. Иногда вам нужен файл, который читает только файлы. По умолчанию для TDD. На Хайку. На Opus. Клод Осьминог позволяет вам раскрутить столько, сколько вам нужно. То же двоичное, разные конфигурации. Каждый из них отображается как отдельный инструмент в вашем MCP-клиенте. 18 - - Claude Agent SDK поставляется в комплекте как зависимость, но он порождает Claude Code под капотом, поэтому вам нужна рабочая установка CLI - (ANTHROPIC API KEY env var) или активная сессия Claude Code OAuth Три пути, выберите тот, который соответствует вашему клиенту MCP. Пропустите установку полностью — см. claude-octopus@latest в вашем .mcp.json, и клиент будет получать по требованию (см. Быстрый запуск ниже). Сервер публикуется в реестре MCP под именем .
Обзор (машинный перевод)
Один мозг, много рук.
Сервер MCP, который заворачивает SDK Claude Agent, позволяя запускать несколько специализированных агентов Claude Code — каждый со своей собственной моделью, инструментами, системной подсказкой и личностью — от любого клиента MCP.
Почему
Код Клода очень мощный. Но один случай делает все одинаково. Иногда вам нужен строгий рецензент кода, который читает только файлы. ** Тестовый автор **, который по умолчанию для TDD. Дешевый помощник на хайку. Глубокий мыслитель на Opus.
Клод Осьминог позволяет вам раскрутить столько, сколько вам нужно. То же двоичное, разные конфигурации. Каждый из них отображается как отдельный инструмент в вашем MCP-клиенте.
Предпосылки
Node.js >= 18
Код Клода — SDK агента Клода в комплекте как зависимость, но он порождает код Клода под капотом, поэтому вам нужна рабочая установка CLI.
Anthropic API key (ANTHROPIC_API_KEY env var) или активная сессия Claude Code OAuth
##Установка
Три пути, выберите тот, который соответствует вашему клиенту MCP.
npm (самый прямой)
npx (не требуется установка)
Пропустите установку полностью — ссылка claude-octopus@latest в .mcp.json, и клиент получит по требованию (см. Быстрый запуск ниже).
Реестр MCP
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
Claude Octopus
One brain, many arms.
An MCP server that wraps the Claude Agent SDK, letting you run multiple specialized Claude Code agents — each with its own model, tools, system prompt, and personality — from any MCP client.
Why
Claude Code is powerful. But one instance does everything the same way. Sometimes you want a strict code reviewer that only reads files. A test writer that defaults to TDD. A cheap quick helper on Haiku. A deep thinker on Opus.
Claude Octopus lets you spin up as many of these as you need. Same binary, different configurations. Each one shows up as a separate tool in your MCP client.
Prerequisites
- Node.js >= 18
- Claude Code — the Claude Agent SDK is bundled as a dependency, but it spawns Claude Code under the hood, so you need a working
claudeCLI installation - Anthropic API key (
ANTHROPIC_API_KEYenv var) or an active Claude Code OAuth session
Install
Three paths, pick whichever matches your MCP client.
npm (most direct)
npm install claude-octopus
npx (no install needed)
Skip the install entirely — reference claude-octopus@latest in your .mcp.json and the client will fetch on demand (see Quick Start below).
MCP Registry
The server is published to the MCP Registry under the name io.github.xiaolai/claude-octopus. Registry-aware MCP clients can resolve and install it by that name without touching npm directly.
Quick Start
The fastest way to get started:
npx claude-octopus init
This interactive wizard lets you pick a template, detects your MCP client, and writes the config for you.
Or add to your .mcp.json manually:
{
"mcpServers": {
"claude": {
"command": "npx",
"args": ["claude-octopus@latest"],
"env": {
"CLAUDE_PERMISSION_MODE": "bypassPermissions"
}
}
}
}
This gives you six tools:
| Tool | Purpose |
|---|---|
claude_code |
Send a task, get a result |
claude_code_reply |
Continue a conversation |
claude_code_timeline |
Query the workflow timeline |
claude_code_transcript |
Read full session transcripts |
claude_code_sessions |
List Claude Code session history (this project, or all) |
claude_code_report |
Generate HTML reports |
That’s it — you have Claude Code as a tool, with full workflow observability built in.
Multiple Agents
The real power is running several instances with different configurations:
{
"mcpServers": {
"code-reviewer": {
"command": "npx",
"args": ["claude-octopus@latest"],
"env": {
"CLAUDE_TOOL_NAME": "code_reviewer",
Установка
npx claude-octopus@latestКонфигурация
{
"mcpServers": {
"claude": {
"command": "npx",
"args": ["claude-octopus@latest"],
"env": {
"CLAUDE_PERMISSION_MODE": "bypassPermissions"
}
}
}
}