---

🤔 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

Your Role	Old Way (Hours)	Persona Way (Seconds)
Python Developer	Research filesystem + git + code-checker + sequential-thinking + memory + fetch servers individually	"persona": "python-backend-engineer" ✨
DevOps Engineer	Configure AWS CLI + CloudFormation + EKS + Docker + Postgres + DynamoDB separately	"persona": "aws-cloud-engineer" ✨
Database Admin	Set up Postgres + monitoring + charting + git + memory + time servers	"persona": "postgresql-dba" ✨

👇 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

Emoji	Meaning	Description
🔐	Secrets Required	Requires API keys, credentials, or sensitive configuration
🌐	Remote Services	Uses external APIs, cloud services, or remote connections
💻	Local Only	Runs entirely locally without external dependencies
⚙️	Configuration	Requires environment variables or configuration setup
🚀	Zero Setup	Works immediately without any configuration
📦	External Dependencies	Requires additional tools or services to be installed
🏢	Enterprise	Designed for production/enterprise environments

💻 Software Engineering

Persona	Labels	Description	MCP Servers	Best For
🐍 Python Developer	💻🚀	Optimized for Python development and data engineering	filesystem, git, python-executor, pytest, pip	Python applications, scripts, data processing
🚀 Python Backend Engineer	💻🚀	Python-focused backend development with code analysis and testing	filesystem, code-checker, sequential-thinking, git, memory, fetch	Python web applications, API development, backend services
🤖 Claude Code Assistant	💻🚀	AI-powered coding assistant for Claude Code users	filesystem, git, sequential-thinking, memory, fetch, time	AI-assisted development, code review, intelligent project guidance
💼 Software Development Assistant	💻🚀	General-purpose software development toolkit	filesystem, git, sequential-thinking, memory, time	General software development, cross-language projects, development workflow automation
🎓 Intern	💻🚀	Learning-focused development environment for beginners	filesystem, git, sequential-thinking, memory, time	Learning programming, educational projects, skill development
🎨 Web UI Engineer Assistant	🔐⚙️	Frontend development automation for prototyping, scaffolding, and UI validation	playwright, shadcn-ui, exa-search	Rapid prototyping, component scaffolding, UI testing, design system integration

📊 Data Science & Analytics

Persona	Labels	Description	MCP Servers	Best For
🐘 PostgreSQL DBA	🔐⚙️🏢	Production PostgreSQL database administration and performance optimization	postgres, postgresql-ops, antv-chart, vchart, filesystem, git, memory, time	Production PostgreSQL administration, database performance tuning, enterprise deployments
🐬 MySQL DBA	🔐⚙️🏢	Production MySQL database administration with web application focus	mysql, antv-chart, vchart, filesystem, git, memory, time	Web application databases, MySQL administration, high-traffic MySQL environments
🪶 SQLite Engineer	⚙️💻	Local development and embedded systems database management	sqlite, antv-chart, filesystem, git, memory, time	Mobile applications, desktop software, embedded systems, data analysis prototyping

☁️ DevOps & Infrastructure

Persona	Labels	Description	MCP Servers	Best For
☁️ AWS Cloud Engineer	🔐🌐⚙️🏢	Comprehensive AWS ecosystem management and automation	aws-cli, aws-api, aws-documentation, aws-cloudformation, aws-cdk, aws-eks, aws-serverless, aws-pricing, filesystem, git, docker, postgres, dynamodb, sequential, time, pulumi	AWS infrastructure management, cloud architecture, enterprise AWS deployments
🌐 Cloud Engineer	⚙️📦	Multi-cloud infrastructure management and DevOps automation	terraform, kubernetes, docker, filesystem	Cloud-agnostic infrastructure, DevOps workflows, container management
📊 Grafana SRE	🔐⚙️🏢	Specialized SRE toolkit for Grafana-based monitoring and observability	filesystem, git, prometheus, docker, postgresql, slack	Grafana-centric monitoring, observability automation, SLI/SLO tracking
🚀 DevOps Engineer Assistant	🔐🌐⚙️	Infrastructure automation specialist for safe deployments and incident mitigation	docker, cloudflare, tavily	Deployment automation, incident response, infrastructure management, operational excellence

✍️ Content & Documentation

Persona	Labels	Description	MCP Servers	Best For
📝 QA Engineer - Documentation	💻🚀	Quality assurance focused on documentation and content validation	filesystem, git, sequential-thinking, memory, time	Documentation quality control, content validation, technical writing QA

🛡️ Security & Compliance

Persona	Labels	Description	MCP Servers	Best For
Coming Soon

🔬 Research & Analysis

Persona	Labels	Description	MCP Servers	Best For
Coming Soon

📋 Project Management

Persona	Labels	Description	MCP Servers	Best For
📋 Linear Project Manager	🔐🌐⚙️	Project management integration with Linear issue tracking	linear, filesystem, git, memory, time	Agile project management, Linear-based workflows, development team coordination
🎯 Trello Project Manager	🔐🌐⚙️	Kanban-style project management with Trello integration	trello, filesystem, git, memory, time	Visual project management, kanban methodology, team collaboration

🧪 Quality Assurance

Persona	Labels	Description	MCP Servers	Best For
🔍 QA Engineer	💻🚀	Comprehensive quality assurance and testing workflows	filesystem, git, sequential-thinking, memory, time	Software testing, quality assurance, test case management

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