agency-mcp-server

단 하나의 MCP 설정 항목으로 150개 이상의 전문 에이전트를 온디맨드로 사용하세요. 수동 설정이 필요 없습니다.

당신의 AI 어시스턴트는 제너럴리스트입니다. 때로는 게임 경제 설계자, 보안 감사자, 기술 작가와 같은 전문가가 필요할 때가 있습니다. 이 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 토큰): 어시스턴트가 agency_search 및 agency_browse 도구를 해결하기 위해 ToolSearch를 호출할 때 로드되는 전체 JSON 도구 스키마를 토큰화하여 측정했습니다. @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시간마다 업데이트를 가져옵니다.

작동 확인

어시스턴트에게 다음과 같이 물어보세요:

"게임 경제 설계자 에이전트를 찾아줘"

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"
      }
    }
  }
}

템플릿 형식

각 에이전트는 부서별로 구성된 YAML 프론트 매터가 포함된 Markdown 파일입니다:

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

크레딧

에이전트 템플릿은 @msitarzewski의 agency-agents에서 가져왔습니다.

라이선스

MIT