Claude Agents Power MCP Server

🚀 🤖 Claude Agents Power

An intelligent MCP server that analyzes your project and recommends the perfect team composition from 100+ professional roles across all company departments.

🚀 Quick Start

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: "Use claude-agents-power to download recommended agents and agents/*.md files for this project."

🤖 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:

"Create a React component using the frontend-developer."
"Analyze this data as a data-scientist."  
"Set up the CI/CD pipeline with the devops-engineer."

✨ 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: 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

📦 Installation

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

💻 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

• - Complete usage guide with best practices
• - Real-world scenarios and use cases
• - Common issues and solutions

🔧 Technical Documentation

• - Step-by-step setup instructions

🔧 Technical Details

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

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

🔍 Can't Find the Agent You Need?

📋 Request a New Agent

1. Check Existing Agents First

   # Search for agents using MCP
   claude-agents-power agents --action search --query "your-role"
   

2. 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"
   

3. 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

1. Fork the Repository

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

2. 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
   

3. Submit a Pull Request

   • Commit your changes
   • Push to your fork
   • Create a PR with description
   • We'll review and merge!

💡 Agent Creation Tips

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

🚀 Roadmap

• [x] GitHub integration for agent templates
• [x] 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.