Claude Agents Power MCP Server

🚀 🤖 Claude Agents Power

Claude Agents Power 是一個智能 MCP 服務器，可分析你的項目，並從公司各部門的 100 多個專業角色中推薦完美的團隊組成。

🚀 快速開始

1️⃣ 安裝並配置 MCP 服務器

# 通過 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: 我將分析你的項目併為你下載推薦的 agents。

[使用 MCP 工具執行以下操作:]
1. 📊 分析你的項目結構 
2. 🎯 推薦合適的角色
3. 📁 將 agents 下載到 ./claude/agents/
4. ✅ 你的項目已準備好使用子 agents！

3️⃣ 驗證安裝

檢查 agents 是否已下載：

ls ./claude/agents/
# 你應該會看到推薦角色的 .md 文件

4️⃣ 開始使用子 agents

現在你可以在 Claude 中使用專業角色：

"請使用 frontend-developer 創建一個 React 組件"
"請以 data-scientist 的身份分析這些數據"  
"請讓 devops-engineer 設置 CI/CD 管道"

✨ 主要特性

🔍 智能項目分析

• 自動檢測項目類型、框架和複雜度
• 根據你的技術棧提供智能角色推薦
• 支持多語言項目和多樣化架構

👥 100+ 專業角色

• 技術與工程（20 個角色）：前端、後端、DevOps、安全、AI/ML
• 數據與分析（15 個角色）：數據科學家、分析師、工程師
• 產品與設計（10 個角色）：產品經理、UX/UI 設計師、研究員
• 營銷與銷售（10 個角色）：數字營銷、增長、內容
• 運營與管理（15 個角色）：項目經理、運營
• 財務與會計（10 個角色）：首席財務官、財務總監、分析師
• 人力資源（10 個角色）：人才招聘、學習與發展、企業文化
• 高管與領導（10 個角色）：C 級高管和戰略專家

🌐 多語言支持

• 英語：全球標準和國際項目
• 韓語：韓國商業環境和本地實踐

⚡ Claude 代碼集成

• 通過 MCP 協議與 Claude Code 無縫集成
• 即時角色推薦和團隊組建
• 一鍵將 agents 安裝到你的項目中

🌐 GitHub 集成

• 從 baryonlabs/claude-sub-agent-contents 自動下載 agents
• 下載跟蹤和使用分析
• 下載的 agents 進行離線緩存
• 安裝到 ./claude/agents/ 目錄結構中
• 無需從頭創建 agent 模板

📦 安裝指南

從源代碼構建

# 克隆倉庫
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"
      }
    }
  }
}

分析與遙測

此工具包含匿名使用分析（遙測），以幫助改善用戶體驗並識別常見使用模式。遙測系統：

• 收集內容：工具使用模式、命令頻率、錯誤率（不收集個人數據）
• 不收集內容：文件內容、agent 數據、GitHub 令牌或任何個人身份信息
• 目的：瞭解哪些功能使用最多，識別常見錯誤，提高性能
• 技術：使用帶有公共 API 密鑰的 PostHog，只能發送事件，不能讀取數據

禁用遙測

如果你不想發送匿名使用數據，可以使用以下方法之一禁用遙測：

# 方法 1：環境變量
export DISABLE_TELEMETRY=true

# 方法 2：在 .env 文件中
DISABLE_TELEMETRY=true

# 替代方法（同樣有效）
DISABLE_ANALYTICS=true

遙測與 OpenTelemetry

本項目使用 產品分析遙測（PostHog），而非 OpenTelemetry：

• 產品分析遙測：跟蹤用戶交互、功能使用和產品指標
• 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：用於在找不到 agents 時自動創建問題的 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"]

# 安裝推薦的 agents
mcp__claude-agents-power__install-agents ["frontend-developer", "backend-developer"]

📋 可用角色

🔧 技術與工程（20 個角色）

📊 數據與分析（15 個角色）

🎨 產品與設計（10 個角色）

📈 營銷與銷售（10 個角色）

⚙️ 運營與管理（15 個角色）

💰 財務與會計（10 個角色）

👥 人力資源（10 個角色）

🏢 高管與領導（10 個角色）

💻 使用示例

📊 下載統計

# 獲取熱門 agents 的下載統計信息
mcp__claude-agents-power__get-download-stats

# 從 GitHub 倉庫刷新 agents
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/         # Agent 定義
│   ├── en/               # 英文 agents（85 個角色）
│   ├── kr/               # 韓語 agents（85 個角色）
│   ├── ja/               # 日語 agents（5 個角色）
│   └── zh/               # 中文 agents（8 個角色）
├── sub-agents/            # 舊版 agent 定義（已棄用）
├── dist/                 # 編譯後的 JavaScript
├── docs/                 # 文檔
└── examples/             # 使用示例

🤝 貢獻代碼

我們歡迎貢獻！請查看我們的 貢獻指南 瞭解詳細信息。

🌟 如何貢獻

1. 添加新角色 - 為特定職位創建 agents
2. 改進翻譯 - 增強韓語/英語本地化
3. 添加項目模板 - 貢獻特定行業的模板
4. 完善文檔 - 改進指南和示例

🔍 找不到所需的 Agent？

如果你找不到所需的特定 agent 角色，可以按以下步驟請求或創建一個：

📋 請求新 Agent

1. 先檢查現有 agents

   # 使用 MCP 搜索 agents
   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）
     • 職責描述
     • 所需工具
     • 使用場景

🛠️ 創建自己的 Agent

Agent 文件格式

在 claude/agents/{language}/ 目錄中創建一個新的 .md 文件：

---
name: your-agent-name
description: 對 agent 的專業知識和職責的簡要描述
tools: Read, Write, Edit, Bash, WebSearch
---

你是一名 [角色名稱]，專注於 [領域/專業知識]。

## 核心職責
- 主要職責 1
- 主要職責 2
- 主要職責 3

## 關鍵實踐
- 最佳實踐或方法 1
- 最佳實踐或方法 2
- 最佳實踐或方法 3

## 工具和技術
- 使用的特定工具或框架
- 你擅長的技術
- 你使用的平臺

## 質量標準
- 質量指標或標準 1
- 質量指標或標準 2
- 性能期望

可用工具

為你的 agent 選擇合適的工具：

• Read, Write, Edit, MultiEdit - 文件操作
• Bash, Grep, Glob - 系統操作
• WebSearch, WebFetch - 互聯網訪問
• TodoWrite, Task - 任務管理
• NotebookRead, NotebookEdit - Jupyter 筆記本支持

示例：創建一個區塊鏈架構師 Agent

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

---
name: blockchain-architect
description: 設計可擴展的分佈式賬本技術解決方案和智能合約架構的區塊鏈系統架構師
tools: Read, Write, Edit, Bash, WebSearch
---

你是一名區塊鏈架構師，專注於分佈式賬本技術和去中心化系統。

## 核心職責
- 設計區塊鏈網絡架構
- 開發智能合約系統
- 實施共識機制
- 確保安全性和可擴展性

## 關鍵實踐
- 遵循安全優先的設計原則
- 優化燃氣效率
- 實施適當的訪問控制
- 設計可升級的合約
- 確保跨鏈兼容性

## 工具和技術
- Ethereum、Polygon、Solana
- Solidity、Rust、Move
- Web3.js、Ethers.js
- Hardhat、Truffle、Foundry
- IPFS、The Graph

## 質量標準
- 智能合約 100% 測試覆蓋率
- 燃氣優化基準
- 安全審計合規性
- 適用時進行形式驗證

📤 提交你的 Agent

1. 分叉倉庫

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

2. 創建你的 Agent 文件

   # 對於英文 agents
   touch claude/agents/en/your-agent-name.md
   
   # 對於韓語 agents
   touch claude/agents/ko/your-agent-name.md
   

3. 提交拉取請求

   • 提交你的更改
   • 推送到你的分叉倉庫
   • 創建一個帶有描述的 PR
   • 我們將進行審核併合並！

💡 Agent 創建提示

1. 明確具體：清晰定義角色的專業知識和邊界
2. 明智選擇工具：僅包含 agent 實際需要的工具
3. 包含示例：添加具體的方法或框架
4. 考慮本地化：提供多種語言的翻譯
5. 測試你的 Agent：確保它能很好地處理實際任務

🚀 路線圖

• [x] 用於 agent 模板的 GitHub 集成
• [x] 下載跟蹤和分析
• [ ] 可視化項目分析儀表板
• [ ] 角色依賴推薦
• [ ] 特定行業的角色捆綁包
• [ ] 與流行項目管理工具的集成
• [ ] 高級團隊組建算法

📄 許可證

本項目採用 MIT 許可證 - 有關詳細信息，請參閱 LICENSE 文件。