XC

xiaolai/claude-octopus

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

21 stars 8 forks Качество 82 Тренд 30ISC

Один мозг, много рук — порождают несколько специализированных агентов кода Клода в качестве 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 claude CLI installation
  • Anthropic API key (ANTHROPIC_API_KEY env 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",
Открыть полный README на GitHub

Установка

npx claude-octopus@latest
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "claude": { "command": "npx", "args": ["claude-octopus@latest"], "env": { "CLAUDE_PERMISSION_MODE": "bypassPermissions" } } } }