Claude Agents Power

🤖 Claude Agents Power

🎯 Smart Role Assignment for Development Teams - An intelligent MCP server that analyzes your project and recommends the perfect team composition from 100+ professional roles across all company departments.

🚀 Quick Start with Claude

1️⃣ Install & Configure MCP Server

# Install via npm
npm install -g claude-agents-power

# Automatically configure Claude Desktop (NEW! 🎉)
claude-agents-power --install

Or manually configure Claude Desktop:

Add to your claude_desktop_config.json:

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

2️⃣ Usage in Claude

Open Claude and try this example:

👤 User: "claude-agents-power를 이용해서 이 프로젝트를 위한 추천 및 agents/*.md 파일을 다운로드 해줘"

🤖 Claude: I'll analyze your project and download the recommended agents for you.

[Uses MCP tools to:]
1. 📊 Analyze your project structure 
2. 🎯 Recommend suitable roles
3. 📁 Download agents to ./claude/agents/
4. ✅ Ready to use sub-agents for your project!

3️⃣ Verify Installation

Check that agents were downloaded:

ls ./claude/agents/
# You should see downloaded .md files for recommended roles

4️⃣ Start Using Sub-Agents

Now you can use specialized roles in Claude:

"frontend-developer를 사용해서 React 컴포넌트를 만들어줘"
"data-scientist로 이 데이터를 분석해줘"  
"devops-engineer가 CI/CD 파이프라인을 설정해줘"

📖 Table of Contents

🌟 Features

🔍 Intelligent Project Analysis

Automatically detects project type, frameworks, and complexity
Provides smart role recommendations based on your tech stack
Supports multi-language projects and diverse architectures

👥 100+ Professional Roles

Technology & Engineering (20 roles): Frontend, Backend, DevOps, Security, AI/ML
Data & Analytics (15 roles): Data Scientists, Analysts, Engineers
Product & Design (10 roles): PM, UX/UI Designers, Researchers
Marketing & Sales (10 roles): Digital Marketing, Growth, Content
Operations & Management (15 roles): Project Managers, Operations
Finance & Accounting (10 roles): CFO, Controllers, Analysts
Human Resources (10 roles): Talent Acquisition, L&D, Culture
Executive & Leadership (10 roles): C-Level executives and strategy

🌐 Multi-Language Support

English: Global standards and international projects
한국어: Korean business context and local practices

⚡ Claude Code Integration

Seamless integration with Claude Code via MCP protocol
Real-time role recommendations and team composition
One-click agent installation to your project

🌐 GitHub Integration

Automatic agent downloading from baryonlabs/claude-sub-agent-contents
Download tracking and usage analytics
Offline caching for downloaded agents
Installs to ./claude/agents/ directory structure
No need to create agent templates from scratch

🚀 Development Setup

Build from Source

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

# Install dependencies
npm install

# Build the project
npm run build

MCP Configuration for Development

Add to your ~/.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"
      }
    }
  }
}

Analytics & Telemetry

This tool includes anonymous usage analytics (telemetry) to help improve the user experience and identify common usage patterns. The telemetry system:

What is collected: Tool usage patterns, command frequency, error rates (no personal data)
What is NOT collected: File contents, agent data, GitHub tokens, or any personally identifiable information
Purpose: Understanding which features are most used, identifying common errors, improving performance
Technology: Uses PostHog with a public API key that can only send events, not read data

Disabling Telemetry

If you prefer not to send anonymous usage data, you can disable telemetry using either of these methods:

# Method 1: Environment variable
export DISABLE_TELEMETRY=true

# Method 2: In your .env file
DISABLE_TELEMETRY=true

# Alternative (also works)
DISABLE_ANALYTICS=true

Telemetry vs OpenTelemetry

This project uses product analytics telemetry (PostHog), not OpenTelemetry:

Product Analytics Telemetry: Tracks user interactions, feature usage, and product metrics
OpenTelemetry: Industry standard for distributed tracing, metrics, and logs in microservices

While both involve "telemetry", they serve different purposes. Our telemetry helps understand how the tool is used to improve the user experience, not for system monitoring or performance tracing.

Environment Variables

Configure these optional environment variables for enhanced functionality:

Method 1: Using .env file (Recommended for local development)

Copy the example environment file:
cp .env.example .env
Edit .env and add your GitHub token:
# GitHub Personal Access Token (required for auto issue creation) GITHUB_TOKEN=ghp_your_actual_token_here # To disable analytics, uncomment: # DISABLE_ANALYTICS=true

Method 2: Using MCP configuration

Add environment variables directly to your MCP server configuration as shown above.

Available Variables

GITHUB_TOKEN: GitHub personal access token for automatic issue creation when agents are not found
- Create at: https://github.com/settings/tokens
- Required permissions: public_repo or repo (for private repos)
DISABLE_TELEMETRY or DISABLE_ANALYTICS: Set to true to disable anonymous usage telemetry
- Telemetry is enabled by default to help improve the tool
- No personal data is collected, only anonymous usage metrics
- Example: DISABLE_TELEMETRY=true
POSTHOG_API_KEY: Custom PostHog API key (optional)
- The tool includes a default public key for analytics
- Only set if you want to use your own PostHog project
POSTHOG_HOST: PostHog instance URL (defaults to https://app.posthog.com)
- Only needed if using a self-hosted PostHog instance

MCP Tools Reference

# Analyze your current project
mcp__claude-agents-power__analyze-project

# Get role recommendations  
mcp__claude-agents-power__recommend-by-keywords ["web", "api", "database"]

# Install recommended agents
mcp__claude-agents-power__install-agents ["frontend-developer", "backend-developer"]

📋 Available Roles

🔧 Technology & Engineering (20 roles)

Role	English	한국어	Tools	Specialization
Software Engineer	EN	KO	`Bash, Read, Write, Edit`	Full-stack development, system design
Frontend Developer	EN	KO	`Read, Write, Edit, Bash`	React, Vue, Angular, UI/UX
Backend Developer	EN	KO	`Bash, Read, Write, Edit`	APIs, databases, server architecture
DevOps Engineer	EN	KO	`Bash, Read, Write`	CI/CD, infrastructure automation
Data Engineer	EN	KO	`Bash, Read, Write`	ETL pipelines, data architecture

Role	English	한국어	Tools	Specialization
ML Engineer	EN	KO	`Bash, Read, Write`	Model deployment, MLOps
Security Engineer	EN	KO	`Bash, Read, Grep`	Cybersecurity, threat analysis
Cloud Architect	EN	KO	`Bash, Read, Write`	AWS, Azure, GCP architecture
Mobile Developer	EN	KO	`Read, Write, Edit, Bash`	iOS, Android, React Native
QA Engineer	EN	KO	`Bash, Read, Write`	Test automation, quality assurance
Database Administrator	EN	KO	`Bash, Read, Write`	Database optimization, backup
Network Engineer	EN	KO	`Bash, Read, Write`	Network infrastructure, security
Site Reliability Engineer	EN	KO	`Bash, Read, Write`	System reliability, monitoring
Blockchain Developer	EN	KO	`Read, Write, Edit`	Smart contracts, DeFi
Game Developer	EN	KO	`Read, Write, Edit`	Unity, Unreal, game engines
Embedded Systems Engineer	EN	KO	`Read, Write, Bash`	IoT, firmware, hardware
Technical Writer	EN	KO	`Read, Write, Edit`	Documentation, API docs
Solution Architect	EN	KO	`Read, Write, Bash`	System integration, design
AI Researcher	EN	KO	`Read, Write, Bash`	Research, algorithm development
Tech Lead	EN	KO	`Read, Write, Edit, Bash`	Team leadership, architecture

📊 Data & Analytics (15 roles)

Role	English	한국어	Tools	Specialization
Data Scientist	EN	KO	`Bash, Read, Write`	ML modeling, statistical analysis
Data Analyst	EN	KO	`Read, Write, Bash`	Business insights, reporting
Business Intelligence Analyst	EN	KO	`Read, Write, Bash`	Dashboards, BI tools
Quantitative Analyst	EN	KO	`Read, Write, Bash`	Financial modeling, risk analysis
Research Analyst	EN	KO	`Read, Write`	Market research, competitive analysis

Role	English	한국어	Tools	Specialization
Analytics Engineer	EN	KO	`Bash, Read, Write`	Data infrastructure, modeling
Marketing Analyst	EN	KO	`Read, Write`	Campaign optimization, metrics
Financial Analyst	EN	KO	`Read, Write`	Financial planning, forecasting
Operations Analyst	EN	KO	`Read, Write, Bash`	Process optimization, efficiency
Product Analyst	EN	KO	`Read, Write`	User behavior, product metrics
Risk Analyst	EN	KO	`Read, Write`	Risk assessment, mitigation
Growth Analyst	EN	KO	`Read, Write`	Growth metrics, experimentation
Customer Insights Analyst	EN	KO	`Read, Write`	Customer segmentation, behavior
Pricing Analyst	EN	KO	`Read, Write`	Pricing strategy, revenue optimization
Supply Chain Analyst	EN	KO	`Read, Write, Bash`	Supply chain optimization

🎨 Product & Design (10 roles)

Role	English	한국어	Tools	Specialization
Product Manager	EN	KO	`Read, Write`	Product strategy, roadmap
Product Designer	EN	KO	`Read, Write`	User experience, product design
UX Designer	EN	KO	`Read, Write`	User research, wireframes
UI Designer	EN	KO	`Read, Write`	Visual design, prototypes
Graphic Designer	EN	KO	`Read, Write`	Brand identity, visual assets

Role	English	한국어	Tools	Specialization
UX Researcher	EN	KO	`Read, Write`	User research, usability testing
Product Owner	EN	KO	`Read, Write`	Backlog management, scrum
Design Lead	EN	KO	`Read, Write`	Design system, team leadership
Creative Director	EN	KO	`Read, Write`	Creative strategy, brand vision
Interaction Designer	EN	KO	`Read, Write`	Interaction design, prototyping

📈 Marketing & Sales (10 roles)

Role	English	한국어	Tools	Specialization
Marketing Manager	EN	KO	`Read, Write`	Marketing strategy, campaigns
Sales Manager	EN	KO	`Read, Write`	Sales strategy, team management
Digital Marketing Specialist	EN	KO	`Read, Write`	Online advertising, SEO/SEM
Content Marketing Manager	EN	KO	`Read, Write`	Content strategy, creation
Social Media Manager	EN	KO	`Read, Write`	Social media strategy, community

Role	English	한국어	Tools	Specialization
SEO Specialist	EN	KO	`Read, Write, Grep`	Search optimization, analytics
Brand Manager	EN	KO	`Read, Write`	Brand strategy, positioning
Growth Marketing Manager	EN	KO	`Read, Write`	Growth hacking, experiments
Account Manager	EN	KO	`Read, Write`	Client relations, account growth
Business Development Manager	EN	KO	`Read, Write`	Partnerships, business growth

⚙️ Operations & Management (15 roles)

Role	English	한국어	Tools	Specialization
Operations Manager	EN	KO	`Read, Write, Bash`	Process optimization, efficiency
Project Manager	EN	KO	`Read, Write`	Project planning, coordination
Program Manager	EN	KO	`Read, Write`	Multi-project coordination
Supply Chain Manager	EN	KO	`Read, Write`	Supply chain optimization
Quality Assurance Manager	EN	KO	`Read, Write, Bash`	Quality processes, improvement

Role	English	한국어	Tools	Specialization
Facilities Manager	EN	KO	`Read, Write`	Facility management, workplace
Procurement Manager	EN	KO	`Read, Write`	Vendor relations, purchasing
Logistics Manager	EN	KO	`Read, Write`	Logistics, delivery optimization
Inventory Manager	EN	KO	`Read, Write`	Inventory control, forecasting
Production Manager	EN	KO	`Read, Write, Bash`	Manufacturing, production
Change Management Specialist	EN	KO	`Read, Write`	Organizational change
Business Process Analyst	EN	KO	`Read, Write`	Process analysis, improvement
Vendor Manager	EN	KO	`Read, Write`	Vendor management, contracts
Compliance Manager	EN	KO	`Read, Write`	Regulatory compliance
Agile Coach	EN	KO	`Read, Write`	Agile methodology, coaching

💰 Finance & Accounting (10 roles)

Role	English	한국어	Tools	Specialization
Chief Financial Officer	EN	KO	`Read, Write`	Financial strategy, corporate finance
Financial Controller	EN	KO	`Read, Write`	Financial control, reporting
Accounting Manager	EN	KO	`Read, Write`	Accounting operations
Treasury Manager	EN	KO	`Read, Write`	Cash management, treasury
Tax Manager	EN	KO	`Read, Write`	Tax strategy, compliance

Role	English	한국어	Tools	Specialization
Internal Auditor	EN	KO	`Read, Write, Grep`	Internal audit, risk assessment
Budget Analyst	EN	KO	`Read, Write`	Budget planning, analysis
Investment Analyst	EN	KO	`Read, Write`	Investment analysis, portfolio
Credit Analyst	EN	KO	`Read, Write`	Credit risk, assessment
Payroll Manager	EN	KO	`Read, Write`	Payroll systems, compensation

👥 Human Resources (10 roles)

Role	English	한국어	Tools	Specialization
HR Manager	EN	KO	`Read, Write`	HR strategy, people management
Talent Acquisition Specialist	EN	KO	`Read, Write`	Recruitment, talent sourcing
HR Business Partner	EN	KO	`Read, Write`	Strategic HR, business alignment
Compensation & Benefits Manager	EN	KO	`Read, Write`	Compensation design, benefits
Learning & Development Manager	EN	KO	`Read, Write`	Training programs, development

Role	English	한국어	Tools	Specialization
Employee Relations Manager	EN	KO	`Read, Write`	Employee relations, conflict resolution
Organizational Development Manager	EN	KO	`Read, Write`	Organization design, change
Diversity & Inclusion Manager	EN	KO	`Read, Write`	D&I strategy, inclusive culture
HR Analyst	EN	KO	`Read, Write`	HR metrics, workforce analytics
Employee Experience Manager	EN	KO	`Read, Write`	Employee journey, culture

🏢 Executive & Leadership (10 roles)

Role	English	한국어	Tools	Specialization
Chief Executive Officer	EN	KO	`Read, Write`	Corporate strategy, leadership
Chief Operating Officer	EN	KO	`Read, Write, Bash`	Operations, execution
Chief Technology Officer	EN	KO	`Read, Write, Edit, Bash`	Technology strategy, innovation
Chief Marketing Officer	EN	KO	`Read, Write`	Marketing strategy, brand
Chief Product Officer	EN	KO	`Read, Write`	Product strategy, innovation

Role	English	한국어	Tools	Specialization
Chief Data Officer	EN	KO	`Read, Write, Bash`	Data strategy, governance
Chief Information Officer	EN	KO	`Read, Write, Bash`	IT strategy, systems
Chief Human Resources Officer	EN	KO	`Read, Write`	HR strategy, culture
Chief Revenue Officer	EN	KO	`Read, Write`	Revenue strategy, growth
Chief Strategy Officer	EN	KO	`Read, Write`	Corporate strategy, planning

🎯 Usage Examples

📊 Download Statistics

# Get download statistics for popular agents
mcp__claude-agents-power__get-download-stats

# Refresh agents from GitHub repository
mcp__claude-agents-power__refresh-agents

🚀 Startup MVP Development

# Analyze project and get recommendations
mcp__claude-agents-power__analyze-project

# Install core startup team
mcp__claude-agents-power__install-agents [
  "product-manager",
  "frontend-developer", 
  "backend-developer",
  "growth-marketing-manager"
]

🏢 Enterprise Application

# Get recommendations for enterprise project
mcp__claude-agents-power__recommend-by-keywords [
  "enterprise", "security", "scalability", "compliance"
]

# Install enterprise team
mcp__claude-agents-power__install-agents [
  "solution-architect",
  "security-engineer",
  "devops-engineer",
  "compliance-manager"
]

📊 Data Platform

# Search for data-related roles
mcp__claude-agents-power__search-agents "data analytics machine learning"

# Install data team
mcp__claude-agents-power__install-agents [
  "data-scientist",
  "data-engineer", 
  "machine-learning-engineer",
  "analytics-engineer"
]

📚 Documentation

📖 User Guides

User Guide - Complete usage guide with best practices
Examples - Real-world scenarios and use cases
Troubleshooting - Common issues and solutions

🔧 Technical Documentation

Installation Guide - Step-by-step setup instructions

🛠️ Development

Prerequisites

Node.js 16+
TypeScript 5+
Claude Code with MCP support

Build from Source

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

Project Structure

claude-agents-power/
├── src/                    # TypeScript source code
├── claude/agents/         # Agent definitions
│   ├── en/               # English agents (85 roles)
│   ├── kr/               # Korean agents (85 roles)
│   ├── ja/               # Japanese agents (5 roles)
│   └── zh/               # Chinese agents (8 roles)
├── sub-agents/            # Legacy agent definitions (deprecated)
├── dist/                 # Compiled JavaScript
├── docs/                 # Documentation
└── examples/             # Usage examples

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

🌟 How to Contribute

Add New Roles - Create agents for specialized positions
Improve Translations - Enhance Korean/English localization
Add Project Templates - Contribute industry-specific templates
Documentation - Improve guides and examples

🔍 Can't Find the Agent You Need?

If you can't find a specific agent role you're looking for, here's how to request or create one:

📋 Request a New Agent

Check Existing Agents First
# Search for agents using MCP claude-agents-power agents --action search --query "your-role"
Automatic Issue Creation (NEW! 🎉)
# Automatically create GitHub Issue when search returns 0 results # Requires GITHUB_TOKEN environment variable export GITHUB_TOKEN=your_github_token # Enable auto issue creation when searching claude-agents-power agents --action search --query "blockchain-architect" --autoCreateIssue true # Or directly create an issue claude-agents-power agents --action request --name "blockchain-architect" --description "Blockchain system design expert"
Manual Issue Submission
- Go to GitHub Issues
- Click "New Issue"
- Use title format: [Agent Request] Role Name - Brief Description
- Include:
  - Role name (e.g., blockchain-architect)
  - Description of responsibilities
  - Required tools
  - Use cases

🛠️ Create Your Own Agent

Agent File Format

Create a new .md file in claude/agents/{language}/ directory:

---
name: your-agent-name
description: Brief description of the agent's expertise and responsibilities
tools: Read, Write, Edit, Bash, WebSearch
---

You are a [role title] specializing in [domain/expertise].

## Core Responsibilities
- Primary responsibility 1
- Primary responsibility 2
- Primary responsibility 3

## Key Practices
- Best practice or methodology 1
- Best practice or methodology 2
- Best practice or methodology 3

## Tools and Technologies
- Specific tools or frameworks used
- Technologies you're expert in
- Platforms you work with

## Quality Standards
- Quality metric or standard 1
- Quality metric or standard 2
- Performance expectations

Available Tools

Choose appropriate tools for your agent:

Read, Write, Edit, MultiEdit - File operations
Bash, Grep, Glob - System operations
WebSearch, WebFetch - Internet access
TodoWrite, Task - Task management
NotebookRead, NotebookEdit - Jupyter notebook support

Example: Creating a Blockchain Architect Agent

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

---
name: blockchain-architect
description: Blockchain system architect designing scalable DLT solutions and smart contract architectures
tools: Read, Write, Edit, Bash, WebSearch
---

You are a blockchain architect specializing in distributed ledger technology and decentralized systems.

## Core Responsibilities
- Design blockchain network architectures
- Develop smart contract systems
- Implement consensus mechanisms
- Ensure security and scalability

## Key Practices
- Follow security-first design principles
- Optimize for gas efficiency
- Implement proper access controls
- Design upgradeable contracts
- Ensure cross-chain compatibility

## Tools and Technologies
- Ethereum, Polygon, Solana
- Solidity, Rust, Move
- Web3.js, Ethers.js
- Hardhat, Truffle, Foundry
- IPFS, The Graph

## Quality Standards
- 100% test coverage for smart contracts
- Gas optimization benchmarks
- Security audit compliance
- Formal verification when applicable

📤 Submit Your Agent

Fork the Repository
git clone https://github.com/hongsw/claude-agents-power-mcp-server.git cd claude-agents-power-mcp-server
Create Your Agent File
# For English agents touch claude/agents/en/your-agent-name.md # For Korean agents touch claude/agents/ko/your-agent-name.md
Submit a Pull Request
- Commit your changes
- Push to your fork
- Create a PR with description
- We'll review and merge!

💡 Agent Creation Tips

Be Specific: Clearly define the role's expertise and boundaries
Choose Tools Wisely: Only include tools the agent actually needs
Include Examples: Add specific methodologies or frameworks
Consider Localization: Provide translations for multiple languages
Test Your Agent: Ensure it works well with real tasks

🚀 Roadmap

GitHub integration for agent templates
Download tracking and analytics
Visual project analyzer dashboard
Role dependency recommendations
Industry-specific role bundles
Integration with popular project management tools
Advanced team composition algorithms

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

⭐ Star this repository if you find it useful!

🐛 Report Bug • ✨ Request Feature • 📖 Documentation

Made with ❤️ for the Claude Code community

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

An intelligent MCP server that analyzes projects and recommends professional role assignments, enabling users to download specialized agent templates for 100+ roles across various company departments.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Tasks Organizer
huntsyea
-
security
A
license
-
quality
An MCP server that converts Cursor agent plans into structured markdown task lists and organizes them in your repository, helping you track AI-generated plans and recommendations as actionable specifications.
Last updated -
10
Python
MIT License
Me-MCP
mihalik
-
security
A
license
-
quality
A personal MCP Server that allows AI agents to retrieve your resume and contact you through Discord webhooks, deployable via Cloudflare Workers.
Last updated -
TypeScript
MIT License
Rules MCP Server
markacianfrani
A
security
F
license
A
quality
An MCP server that allows coding agents to look up contextual rules and patterns on demand, providing just-in-time guidance for specific tasks like writing tests or authoring UI.
Last updated -
1
4
TypeScript
Orchestrator MCP
Phoenixrr2113
A
security
F
license
A
quality
An intelligent MCP server that orchestrates multiple MCP servers with AI-enhanced workflow automation and production-ready context engine capabilities for codebase analysis.
Last updated -
3
TypeScript

View all related MCP servers