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 文件。