Claude Agents Power MCP Server

## 🚀 Claude Agents Power

*開発チームのための賢い役割割り当て - あなたのプロジェクトを分析し、全社の部署にまたがる100以上の専門的な役割から最適なチーム構成を推薦する、インテリジェントなMCPサーバーです。*

## 🚀 クイックスタート

### 1️⃣ MCPサーバーのインストールと設定

```bash
# npmを通じてインストール
npm install -g claude-agents-power

# Claude Desktopを自動的に設定（新機能！🎉）
claude-agents-power --install

または、Claude Desktopを手動で設定するには：

claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "claude-agents-power": {
      "command": "npx",
      "args": ["claude-agents-power"]
    }
  }
}

2️⃣ Claudeでの使用方法

Claudeを開き、この例を試してみてください。

👤 ユーザー: "claude-agents-powerを利用してこのプロジェクトに適した推薦とagents/*.mdファイルをダウンロードしてください"

🤖 Claude: あなたのプロジェクトを分析し、推薦されるエージェントをダウンロードします。

[MCPツールを使用して:]
1. 📊 プロジェクト構造を分析する
2. 🎯 適切な役割を推薦する
3. 📁 エージェントを./claude/agents/にダウンロードする
4. ✅ あなたのプロジェクトでサブエージェントを使用できるようになりました！

3️⃣ インストールの確認

エージェントがダウンロードされたことを確認します。

ls ./claude/agents/
# 推薦された役割に対応する.mdファイルが表示されるはずです

4️⃣ サブエージェントの使用開始

これで、Claudeで専門的な役割を使用できます。

"frontend-developerを使用してReactコンポーネントを作成してください"
"data-scientistでこのデータを分析してください"  
"devops-engineerがCI/CDパイプラインを設定してください"

✨ 主な機能

🔍 インテリジェントなプロジェクト分析

• プロジェクトのタイプ、フレームワーク、複雑さを自動検出します。
• あなたのテクノロジースタックに基づいて、賢い役割の推薦を提供します。
• 多言語プロジェクトや多様なアーキテクチャをサポートします。

👥 100以上の専門的な役割

• テクノロジーとエンジニアリング (20役割): フロントエンド、バックエンド、DevOps、セキュリティ、AI/ML
• データと分析 (15役割): データサイエンティスト、アナリスト、エンジニア
• プロダクトとデザイン (10役割): プロダクトマネージャー、UX/UIデザイナー、リサーチャー
• マーケティングとセールス (10役割): デジタルマーケティング、グロース、コンテンツ
• オペレーションと管理 (15役割): プロジェクトマネージャー、オペレーション
• 財務と会計 (10役割): CFO、コントローラー、アナリスト
• 人事 (10役割): 人材獲得、研修、組織文化
• 経営陣とリーダーシップ (10役割): Cレベルの経営者と戦略

🌐 多言語サポート

• 英語: グローバルな標準と国際的なプロジェクトに対応
• 韓国語: 韓国のビジネス環境と現地の慣行に対応

⚡ Claude Codeとの統合

• MCPプロトコルを通じてClaude Codeとシームレスに統合されます。
• リアルタイムの役割推薦とチーム構成を提供します。
• ワンクリックでエージェントをあなたのプロジェクトにインストールできます。

🌐 GitHubとの統合

• baryonlabs/claude-sub-agent-contentsから自動的にエージェントをダウンロードします。
• ダウンロードの追跡と使用状況の分析を行います。
• ダウンロードしたエージェントのオフラインキャッシュをサポートします。
• ./claude/agents/ディレクトリ構造にインストールされます。
• エージェントテンプレートを最初から作成する必要はありません。

📦 インストール

ソースからビルド

# リポジトリをクローンする
git clone https://github.com/hongsw/claude-agents-power-mcp-server.git
cd claude-agents-power

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

開発用のMCP設定

~/.config/claude/mcp_servers.jsonに以下を追加します。

{
  "mcpServers": {
    "claude-agents-power": {
      "command": "node",
      "args": ["/path/to/claude-agents-power/dist/index.js"],
      "cwd": "/path/to/your/project",
      "env": {
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

分析とテレメトリ

このツールには匿名の使用状況分析（テレメトリ）が含まれており、ユーザーエクスペリエンスの向上と一般的な使用パターンの特定に役立ちます。テレメトリシステムは以下のように動作します。

• 収集される情報: ツールの使用パターン、コマンドの頻度、エラー率（個人データは収集されません）
• 収集されない情報: ファイル内容、エージェントデータ、GitHubトークン、または個人を特定できる情報
• 目的: 最もよく使用される機能の把握、一般的なエラーの特定、パフォーマンスの向上
• 技術: イベントの送信のみが可能で、データの読み取りはできない公開APIキーを使用したPostHogを利用

テレメトリの無効化

匿名の使用データを送信したくない場合は、以下のいずれかの方法でテレメトリを無効にできます。

# 方法1: 環境変数を使用
export DISABLE_TELEMETRY=true

# 方法2: .envファイルに記載
DISABLE_TELEMETRY=true

# 別の方法（同様に機能します）
DISABLE_ANALYTICS=true

テレメトリとOpenTelemetryの違い

このプロジェクトでは、OpenTelemetryではなくプロダクト分析テレメトリ（PostHog）を使用しています。

• プロダクト分析テレメトリ: ユーザーの相互作用、機能の使用状況、および製品のメトリクスを追跡します。
• OpenTelemetry: マイクロサービスにおける分散トレーシング、メトリクス、およびログの業界標準です。

両者とも「テレメトリ」と呼ばれますが、目的は異なります。このツールのテレメトリは、システムの監視やパフォーマンスのトレーシングではなく、ユーザーエクスペリエンスの向上のためにツールの使用方法を理解するのに役立ちます。

環境変数

拡張機能を使用するために、これらのオプションの環境変数を設定します。

方法1: .envファイルを使用する（ローカル開発に推奨）

1. サンプル環境ファイルをコピーします。

   cp .env.example .env
   

2. .envを編集し、GitHubトークンを追加します。

   # GitHub個人アクセストークン（自動イシュー作成に必要）
   GITHUB_TOKEN=ghp_your_actual_token_here
   
   # 分析を無効にするには、コメントを外します。
   # DISABLE_ANALYTICS=true
   

方法2: MCP設定を使用する

上記のように、環境変数を直接MCPサーバー設定に追加します。

利用可能な変数

• GITHUB_TOKEN: エージェントが見つからない場合に自動的にイシューを作成するためのGitHub個人アクセストークン

  • 作成先: https://github.com/settings/tokens
  • 必要なパーミッション: public_repoまたはrepo（プライベートリポジトリの場合）

• DISABLE_TELEMETRY または DISABLE_ANALYTICS: 匿名の使用状況テレメトリを無効にするにはtrueに設定します。

  • テレメトリはツールの改善のためにデフォルトで有効になっています。
  • 個人データは収集されず、匿名の使用メトリクスのみが収集されます。
  • 例: DISABLE_TELEMETRY=true

• POSTHOG_API_KEY: カスタムのPostHog APIキー（オプション）

  • ツールには分析用のデフォルトの公開キーが含まれています。
  • 独自のPostHogプロジェクトを使用したい場合のみ設定してください。

• POSTHOG_HOST: PostHogインスタンスのURL（デフォルトはhttps://app.posthog.com）

  • 自己ホスト型のPostHogインスタンスを使用する場合のみ必要です。

MCPツールの参照

# 現在のプロジェクトを分析する
mcp__claude-agents-power__analyze-project

# 役割の推薦を取得する
mcp__claude-agents-power__recommend-by-keywords ["web", "api", "database"]

# 推薦されたエージェントをインストールする
mcp__claude-agents-power__install-agents ["frontend-developer", "backend-developer"]

📋 利用可能な役割

🔧 テクノロジーとエンジニアリング (20役割)

📊 データと分析 (15役割)

🎨 プロダクトとデザイン (10役割)

📈 マーケティングとセールス (10役割)

⚙️ オペレーションと管理 (15役割)

💰 財務と会計 (10役割)

👥 人事 (10役割)

🏢 経営陣とリーダーシップ (10役割)

💻 使用例

📊 ダウンロード統計

# 人気のエージェントのダウンロード統計を取得する
mcp__claude-agents-power__get-download-stats

# GitHubリポジトリからエージェントを更新する
mcp__claude-agents-power__refresh-agents

🚀 スタートアップMVP開発

# プロジェクトを分析し、推薦を取得する
mcp__claude-agents-power__analyze-project

# スタートアップのコアチームをインストールする
mcp__claude-agents-power__install-agents [
  "product-manager",
  "frontend-developer", 
  "backend-developer",
  "growth-marketing-manager"
]

🏢 エンタープライズアプリケーション

# エンタープライズプロジェクトの推薦を取得する
mcp__claude-agents-power__recommend-by-keywords [
  "enterprise", "security", "scalability", "compliance"
]

# エンタープライズチームをインストールする
mcp__claude-agents-power__install-agents [
  "solution-architect",
  "security-engineer",
  "devops-engineer",
  "compliance-manager"
]

📊 データプラットフォーム

# データ関連の役割を検索する
mcp__claude-agents-power__search-agents "data analytics machine learning"

# データチームをインストールする
mcp__claude-agents-power__install-agents [
  "data-scientist",
  "data-engineer", 
  "machine-learning-engineer",
  "analytics-engineer"
]

📚 ドキュメント

📖 ユーザーガイド

• - ベストプラクティスを含む完全な使用ガイド
• - 実際のシナリオとユースケース
• - 一般的な問題と解決策

🔧 技術ドキュメント

• - ステップバイステップのセットアップ手順

🛠️ 開発

前提条件

• Node.js 16+
• TypeScript 5+
• MCPをサポートするClaude Code

ソースからビルド

git clone https://github.com/hongsw/claude-agents-power-mcp-server.git
cd claude-agents-power
npm install
npm run build
npm test

プロジェクト構造

claude-agents-power/
├── src/                    # TypeScriptソースコード
├── claude/agents/         # エージェント定義
│   ├── en/               # 英語のエージェント (85役割)
│   ├── kr/               # 韓国語のエージェント (85役割)
│   ├── ja/               # 日本語のエージェント (5役割)
│   └── zh/               # 中国語のエージェント (8役割)
├── sub-agents/            # レガシーエージェント定義 (非推奨)
├── dist/                 # コンパイルされたJavaScript
├── docs/                 # ドキュメント
└── examples/             # 使用例

🤝 コントリビューション

コントリビューションを歓迎します！詳細については、コントリビューションガイドを参照してください。

🌟 コントリビューションの方法

1. 新しい役割の追加 - 専門的なポジションに対応するエージェントを作成します。
2. 翻訳の改善 - 韓国語/英語のローカライズを強化します。
3. プロジェクトテンプレートの追加 - 業界固有のテンプレートを提供します。
4. ドキュメント - ガイドとサンプルを改善します。

🔍 必要なエージェントが見つからない場合

必要な特定のエージェント役割が見つからない場合は、以下の方法で要求または作成できます。

📋 新しいエージェントの要求

1. 既存のエージェントを確認する

   # MCPを使用してエージェントを検索する
   claude-agents-power agents --action search --query "your-role"
   

2. 自動イシュー作成 (新機能！🎉)

   # 検索結果が0件の場合に自動的にGitHubイシューを作成する
   # GITHUB_TOKEN環境変数が必要です。
   export GITHUB_TOKEN=your_github_token
   
   # 検索時に自動イシュー作成を有効にする
   claude-agents-power agents --action search --query "blockchain-architect" --autoCreateIssue true
   
   # または、直接イシューを作成する
   claude-agents-power agents --action request --name "blockchain-architect" --description "Blockchain system design expert"
   

3. 手動でイシューを提出する

   • GitHubイシューにアクセスします。
   • 「New Issue」をクリックします。
   • タイトル形式: [Agent Request] Role Name - Brief Description を使用します。
   • 以下を含めます。
     • 役割名 (例: blockchain-architect)
     • 責任の説明
     • 必要なツール
     • 使用例

🛠️ 独自のエージェントの作成

エージェントファイル形式

claude/agents/{language}/ディレクトリに新しい.mdファイルを作成します。

---
name: your-agent-name
description: エージェントの専門分野と責任の簡単な説明
tools: Read, Write, Edit, Bash, WebSearch
---

あなたは[役割名]で、[ドメイン/専門分野]を専門としています。

## 主要な責任
- 主要な責任1
- 主要な責任2
- 主要な責任3

## 重要な実践
- ベストプラクティスまたは方法論1
- ベストプラクティスまたは方法論2
- ベストプラクティスまたは方法論3

## ツールとテクノロジー
- 使用する特定のツールまたはフレームワーク
- 得意なテクノロジー
- 利用するプラットフォーム

## 品質基準
- 品質メトリックまたは基準1
- 品質メトリックまたは基準2
- パフォーマンス期待値

利用可能なツール

エージェントに適切なツールを選択します。

• Read, Write, Edit, MultiEdit - ファイル操作
• Bash, Grep, Glob - システム操作
• WebSearch, WebFetch - インターネットアクセス
• TodoWrite, Task - タスク管理
• NotebookRead, NotebookEdit - Jupyterノートブックサポート

例: ブロックチェーンアーキテクトエージェントの作成

claude/agents/en/blockchain-architect.md:

---
name: blockchain-architect
description: スケーラブルなDLTソリューションとスマートコントラクトアーキテクチャを設計するブロックチェーンシステムアーキテクト
tools: Read, Write, Edit, Bash, WebSearch
---

あなたは分散台帳技術と分散システムを専門とするブロックチェーンアーキテクトです。

## 主要な責任
- ブロックチェーンネットワークアーキテクチャを設計する
- スマートコントラクトシステムを開発する
- コンセンサスメカニズムを実装する
- セキュリティとスケーラビリティを確保する

## 重要な実践
- セキュリティを第一に考慮した設計原則に従う
- ガス効率を最適化する
- 適切なアクセス制御を実装する
- アップグレード可能なコントラクトを設計する
- クロスチェーン互換性を確保する

## ツールとテクノロジー
- Ethereum, Polygon, Solana
- Solidity, Rust, Move
- Web3.js, Ethers.js
- Hardhat, Truffle, Foundry
- IPFS, The Graph

## 品質基準
- スマートコントラクトの100%テストカバレッジ
- ガス最適化ベンチマーク
- セキュリティ監査のコンプライアンス
- 適用可能な場合は形式検証

📤 エージェントの提出

1. リポジトリをフォークする

   git clone https://github.com/hongsw/claude-agents-power-mcp-server.git
   cd claude-agents-power-mcp-server
   

2. エージェントファイルを作成する

   # 英語のエージェントの場合
   touch claude/agents/en/your-agent-name.md
   
   # 韓国語のエージェントの場合
   touch claude/agents/ko/your-agent-name.md
   

3. **プルリクエストを提出