Agency Mcp Server

agency-mcp-server

MCP の設定を 1 つ追加するだけで、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/）に直接コピーします。問題なく動作しますが、使用するかどうかにかかわらず、すべてのエージェントの名前と説明が、あらゆる会話のコンテキストウィンドウに読み込まれます。

実際に計測しました。

方法	コンテキストのコスト	タイミング
インストール済みエージェント（~/.claude/agents/）	約 8,300 トークン	毎回の会話。常時
MCP サーバー（待機中）	約 55 トークン	毎回の会話
MCP サーバー（検索時）	約 350 トークン	検索時のみ
MCP サーバー（エージェント使用時）	約 2,700 トークン	エージェント起動時のみ（中央値）

これにより、基本のコンテキスト使用量を150 分の 1に削減できます。同じ 160 種類以上のエージェントを利用できますが、実際に使うエージェントの分だけコストがかかります。

計測方法

インストール済みエージェント（8,300 トークン）： agency-agents のインストールスクリプト（install.sh --tool claude-code）を実行し、162 個のエージェントファイルを ~/.claude/agents/ にコピーしました。その後、新しい Claude Code セッションを開いて /context を実行しました。Claude Code は「カスタムエージェント：8.3k トークン」と報告しました。これは、エージェントを使用するかどうかにかかわらず、あらゆる会話に読み込まれます。

MCP 待機時（55 トークン）： 代わりに MCP サーバーを設定した場合、/context に表示されるのは、遅延読み込みされる 2 つのツール名（agency_search、agency_browse）とシステムプロンプト内の簡単なサーバーの説明だけです。エージェントのデータは読み込まれません。

MCP 検索時（350 トークン）： アシスタントが ToolSearch を呼び出して agency_search と agency_browse ツールを解決する際に読み込まれる、ツールの完全な JSON スキーマをトークン化して計測しました。計測には @anthropic-ai/tokenizer を使用しました。

MCP エージェント使用時（2,700 トークン）： 145 個すべてのエージェントファイルのトークン数の中央値です。@anthropic-ai/tokenizer で計測しました。コンテキストに読み込まれるのは、実際に使用する 1 つのエージェントファイルだけです。エージェントによって 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 秒）。

仕組み

アシスタントでは、次の4つのツールを利用できます。

1. agency_search(query, division?) -- タスクを説明すると、該当するエージェントと起動手順が返されます
2. agency_browse(division?) -- 利用可能なものを確認したいときに、部門やエージェントを一覧できます
3. agency_status() -- インデックスの最新状況（エージェント数、最終更新時刻、更新が利用可能かどうか）を確認します
4. agency_update() -- 再起動せずに、Git から最新のテンプレートを取得して検索インデックスを再構築します

具体的な作業について支援を求めると、アシスタントは agency_search を呼び出し、最適な候補を選んで、その専門家の完全なシステムプロンプトを使ってサブエージェントを起動します。設定ファイルを操作する必要はなく、専門家の回答を得られます。

利用できる内容

エージェントは部門別に整理されています。

部門	例
エンジニアリング	ソフトウェアアーキテクト、DevOps エンジニア、テクニカルライター
デザイン	UI デザイナー、UX リサーチャー、デザインシステム
ゲーム開発	ゲームエコノミーデザイナー、ゲームメカニクスデザイナー
マーケティング	コンテンツストラテジスト、SEO スペシャリスト、メールマーケティング
セキュリティと専門分野	セキュリティ監査担当者、データサイエンティスト、法律アナリスト
...その他	学術、営業、戦略、サポート、テスト、空間コンピューティング

設定

設定はすべて、MCP 設定内の環境変数を通じて行います。

変数	デフォルト	説明
AGENCY_AGENTS_PATH	~/.cache/agency-mcp-server/agency-agents	エージェントテンプレートのパスです。自動クローンの代わりに独自のテンプレートを使う場合に設定します
AGENCY_REPO_URL	https://github.com/msitarzewski/agency-agents.git	テンプレートのクローン元となる Git リポジトリです。自分のフォークを指定できます
AGENCY_AUTO_UPDATE	true	自動取得を無効にするには false に設定します
AGENCY_UPDATE_INTERVAL	24	更新を確認する間隔（時間）です

独自のテンプレートを使う

ローカルディレクトリを指定します。

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