agency-mcp-server

Одна запись в конфигурации MCP. 150+ специализированных агентов по запросу. Никакой ручной настройки.

Ваш ИИ-ассистент — универсал. Иногда вам нужен специалист — дизайнер игровой экономики, аудитор безопасности, технический писатель. Этот MCP-сервер дает вашему ассистенту мгновенный доступ к более чем 150 шаблонам экспертных агентов. Опишите, что вам нужно, и он найдет подходящего агента и запустит его.

You: "Help me design a balanced game economy"
Claude: [searches -> finds Game Economy Designer -> spawns it -> expert response]

Шаблоны автоматически загружаются при первом запуске из agency-agents и остаются актуальными. Вам не нужно ничего делать.

Почему бы просто не установить агентов локально?

Вы можете. Скрипт установки agency-agents копирует все 160+ файлов агентов прямо в директорию конфигурации вашего инструмента (например, ~/.claude/agents/). Это работает, но имя и описание каждого агента загружаются в контекстное окно каждого диалога, используете вы их или нет.

Мы провели замеры:

Это 150-кратное снижение базового использования контекста. Вы получаете те же 160+ агентов, но платите только за того, которого используете в данный момент.

Установленные агенты (8 300 токенов): Мы запустили скрипт установки agency-agents (install.sh --tool claude-code), который скопировал 162 файла агентов в ~/.claude/agents/. Затем открыли новую сессию Claude Code и выполнили /context. Claude Code сообщил: "Custom agents: 8.3k tokens" — они загружаются в каждый диалог независимо от того, используется ли какой-либо агент.

MCP в режиме ожидания (55 токенов): Если вместо этого настроен MCP-сервер, /context показывает только имена двух отложенных инструментов (agency_search, agency_browse) и краткое описание сервера в системном промпте. Данные агентов не загружаются.

MCP поиск (350 токенов): Измерено путем токенизации полных JSON-схем инструментов, которые загружаются, когда ассистент вызывает ToolSearch для разрешения инструментов agency_search и agency_browse. Подсчитано с помощью @anthropic-ai/tokenizer.

MCP использование агента (2 700 токенов): Медианное количество токенов по всем 145 файлам агентов, измеренное с помощью @anthropic-ai/tokenizer. В контекст загружается только тот файл агента, который вы используете. Диапазон составляет 383–12 724 токена в зависимости от агента (p25: 1 549, p75: 3 584).

Быстрый старт

Claude Code

Как плагин:

/plugin marketplace add npupko/agency-mcp-server
/plugin install agency@agency-mcp-server

Или через CLI:

claude mcp add agency -- npx -y agency-mcp-server

Cursor, Windsurf и другие MCP-клиенты

Добавьте в свою конфигурацию MCP:

{
  "mcpServers": {
    "agency": {
      "command": "npx",
      "args": ["-y", "agency-mcp-server"]
    }
  }
}

Это всё. При первом запуске шаблоны клонируются в ~/.cache/agency-mcp-server/ и обновления подтягиваются каждые 24 часа.

Проверка работоспособности

Спросите своего ассистента:

"Search for a game economy designer agent"

Вы должны увидеть результаты от инструмента agency_search. Если это первый запуск, шаблоны будут автоматически загружены (~30 секунд).

Как это работает

Ваш ассистент получает четыре инструмента:

1. agency_search(query, division?) — опишите задачу, получите подходящих агентов с инструкциями по запуску

2. agency_browse(division?) — изучите разделы и агентов, если хотите увидеть, что доступно

3. agency_status() — проверьте свежесть индекса: количество агентов, время последнего обновления, наличие доступных обновлений

4. agency_update() — подтяните последние шаблоны из git и пересоберите индекс поиска без перезагрузки

Когда вы просите помощи с чем-то конкретным, ваш ассистент вызывает agency_search, выбирает лучший вариант и запускает субагента с полным системным промптом этого специалиста. Вы получаете экспертный ответ, не касаясь конфигурационного файла.

Что доступно

Агенты организованы по разделам:

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

Вся настройка осуществляется через переменные окружения в вашей конфигурации MCP:

Используйте свои шаблоны

Укажите локальную директорию:

{
  "mcpServers": {
    "agency": {
      "command": "npx",
      "args": ["-y", "agency-mcp-server"],
      "env": {
        "AGENCY_AGENTS_PATH": "/path/to/your/agent-templates"
      }
    }
  }
}

Или клонируйте из своего репозитория:

{
  "mcpServers": {
    "agency": {
      "command": "npx",
      "args": ["-y", "agency-mcp-server"],
      "env": {
        "AGENCY_REPO_URL": "https://github.com/yourorg/custom-agents.git"
      }
    }
  }
}

Формат шаблона

Каждый агент — это Markdown-файл с YAML-заголовком, организованный по разделам:

engineering/
  software-architect.md
  devops-engineer.md
design/
  ui-designer.md
game-development/
  game-economy-designer.md

---
name: Software Architect
description: Expert software architect specializing in system design...
---

Full agent system prompt goes here.

Сервер индексирует поля name и description для поиска. Полное тело Markdown становится системным промптом агента при запуске.

Интерфейс MCP

Инструменты

• agency_search(query, division?) — поиск агентов по описанию задачи, возвращает совпадения с путями к файлам и готовым шаблоном запуска

• agency_browse(division?) — список всех разделов или список агентов в конкретном разделе

• agency_status() — проверка свежести индекса: количество агентов, время последнего обновления, необходимость обновления

• agency_update() — подтянуть последние шаблоны из git и пересобрать индекс поиска во время выполнения

Ресурсы

• agency://agents — полный индекс агентов в формате JSON

• agency://divisions — список разделов с количеством и примерами

Промпты

• use-agent — опишите задачу, получите наиболее подходящего агента с инструкциями по запуску

Разработка

npm install
npm run build

# Run with auto-fetched templates
node dist/index.js

# Run with local templates
AGENCY_AGENTS_PATH=./my-agents node dist/index.js

# Type checking
npm run typecheck

# MCP Inspector
npm run inspect

Авторы

Шаблоны агентов от agency-agents авторства @msitarzewski.

Лицензия

MIT