🎭 Awesome MCP Personas

🚀 Stop juggling individual MCP servers — Get a complete AI toolkit for your role in seconds

🤔 What's an MCP Persona?

If you've been manually copying mcp.json files and wondering which MCP servers work well together, personas solve that problem.

Instead of this tedious process:

- ❌ Research 50+ individual MCP servers
- ❌ Test which ones work together
- ❌ Configure each server individually  
- ❌ Debug compatibility issues
- ❌ Repeat for every new project

Get this instant setup:

+ ✅ Install one persona = get 5-15 perfectly configured MCP servers
+ ✅ Community-created toolkits using validated MCP servers from established registries
+ ✅ Zero compatibility issues, zero debugging
+ ✅ Works immediately in Claude Code, Cursor, Continue, etc.

🎯 Real Examples

👇 Browse All 16 Personas

⚡ Two Ways to Get Started

🏃‍♂️ Quick Start: Copy & Paste (30 seconds)

Pick a persona from the catalog below or browse the personas/ directory. Start with intern if you're new!

🤖 Claude Code

cp personas/intern/mcp.json ./.mcp.json

⚡ Cursor

cp personas/intern/mcp.json ~/.cursor/mcp.json

🔧 Other Applications

# Copy to your application's mcp.json location
cp personas/intern/mcp.json <your-app-config-path>/mcp.json

⚠️ Note: Replace any <placeholder> values with your actual credentials.

🚀 Full Features: Hypertool Setup (2 minutes)

Get access to complete persona features including organized toolsets, workflows, and advanced configurations:

# Step 1: Clone this repository
git clone https://github.com/toolprint/awesome-mcp-personas.git

# Step 2: Install hypertool globally
npm install -g @toolprint/hypertool-mcp@latest

# Step 3: Add a persona (example: intern)
hypertool-mcp persona add ./awesome-mcp-personas/personas/intern

# Step 4: Update your application or project's mcp.json

{
  "mcpServers": {
    "hypertool": {
      "command": "npx",
      "args": ["-y", "@toolprint/hypertool-mcp@latest", "mcp", "run", "--persona", "intern"]
    }
  }
}

✨ Hypertool Benefits: Organized toolsets, compound workflows, persona updates, and community-contributed configurations using MCP servers from established registries. Learn more at hypertool-mcp.

How Hypertool Works (Loader Pattern)

Standard MCP:                         With Hypertool:
┌─────────────┐                      ┌─────────────┐
│ Claude/     │                      │ Claude/     │
│ Cursor      │                      │ Cursor      │  
└──────┬──────┘                      └──────┬──────┘
       │                                     │
       ▼                                     ▼
┌─────────────┐                      ┌─────────────┐
│ mcp.json    │                      │ mcp.json    │
│ (10 servers)│                      │ (1 loader)  │
└──────┬──────┘                      └──────┬──────┘
       │                                     │
       ▼                                     ▼
  10 connections                     ┌─────────────┐
  10 configs                         │  Hypertool  │
  10 updates                         │   Persona   │
       │                             └──────┬──────┘
       ▼                                     │
┌─────────────┐                             ▼
│ 100+ tools  │                      ┌─────────────┐
│ ALL loaded  │                      │  Smart      │
│ 😵 Confusion│                      │  Toolsets   │
└─────────────┘                      │  🎯 5 tools │
                                     │  per task   │
                                     └─────────────┘
                                            │
                                            ▼
                                     Context compression:
                                     "coding" → 5 tools
                                     "writing" → 3 tools
                                     "testing" → 4 tools

👥 Personas Catalog

🏷️ Legend

💻 Software Engineering

📊 Data Science & Analytics

☁️ DevOps & Infrastructure

✍️ Content & Documentation

🛡️ Security & Compliance

🔬 Research & Analysis

📋 Project Management

🧪 Quality Assurance

📝 Creating a Persona

Quick Start with Claude Code

If you're using Claude Code, simply run:

/new-persona

Claude will guide you through creating a properly formatted persona with all required files.

After creating your persona, run:

/sync-personas

This will automatically add your new persona to the README with proper categorization and emoji labeling.

Manual Creation

Each persona consists of:

1. persona.yaml - The persona definition with toolsets and metadata
2. mcp.json - The MCP server configuration file
3. README.md - Documentation describing the persona's purpose and usage

Persona Structure

personas/
├── your-persona-name/
│   ├── persona.yaml      # Persona definition (required)
│   ├── mcp.json          # MCP server configuration (required)
│   ├── README.md         # Persona documentation (recommended)
│   ├── tools.md          # Tool reference guide (optional)
│   └── validation_notes.md # Configuration notes (optional)

Example Configuration

See existing personas for complete examples:

• python-backend-engineer - Python-focused backend development with code analysis
• postgresql-dba - Complex persona with specialized toolsets
• claude-code-assistant - AI-assisted development persona

🤝 Contributing

We welcome contributions! Here's how you can help:

Ways to Contribute

• 🆕 Add a new persona: Create configurations for your profession or use case
• 🔧 Improve existing personas: Enhance configurations with better tool combinations
• 📚 Share workflows: Add example workflows and best practices
• 🐛 Fix issues: Help maintain and update existing personas
• 📖 Improve documentation: Enhance README files and guides

Submission Guidelines

• Ensure your persona has a clear, specific use case
• Use only validated MCP servers from established registries (see Resources section)
• Test the configuration before submitting
• Include comprehensive documentation
• Follow the established directory structure
• Add your persona to the appropriate category in this README
• Community review helps ensure quality and compatibility

Please see our GitHub Issues for bug reports and GitHub Discussions for questions.

📚 Resources

MCP Server Registries

All personas in this repository are community-created with best effort made to ensure that only validated MCP servers from the following established registries are used:

• Awesome MCP Servers - Comprehensive community-maintained list of MCP servers
• Model Context Protocol - Official MCP documentation and server registry
• Smithery Registry - Curated registry of MCP servers
• NPM Registry - Published MCP server packages

Related Projects

• Hypertool MCP - Persona installation and management tool

Community

• GitHub Issues - Report bugs or request features
• GitHub Discussions - Ask questions and share ideas

📊 Statistics

License

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