justmy2satoshis/expert-roles-mcp

Expert Roles MCP Server

A comprehensive MCP (Model Context Protocol) server that provides 33 expert AI consultation roles across 8 specialized categories with integrated workflow orchestration capabilities. Fully compatible with Windows, Linux, and macOS.

🚀 Features

• 33 Expert Roles across 8 specialized categories
• Intelligent Expert Nomination: Advanced TF-IDF weighted algorithm with 95%+ accuracy
• Workflow Orchestration: 8 pre-built workflow templates + custom workflow creation
• Cross-Platform: Works on Windows, Linux, and macOS
• Production Ready: Includes PM2 and systemd configurations

📋 Quick Start

Windows

git clone https://github.com/justmy2satoshis/expert-roles-mcp.git
cd expert-roles-mcp
npm install --production
start.bat

Linux/macOS

git clone https://github.com/justmy2satoshis/expert-roles-mcp.git
cd expert-roles-mcp
npm install --production
chmod +x start.sh
./start.sh

Vultr Ubuntu Deployment

wget https://raw.githubusercontent.com/justmy2satoshis/expert-roles-mcp/main/deploy-vultr.sh
chmod +x deploy-vultr.sh
./deploy-vultr.sh

⚙️ Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "expert-roles": {
      "command": "node",
      "args": ["/path/to/expert-roles-mcp/mcp-server-commonjs.js"],
      "env": {"NODE_NO_WARNINGS": "1"}
    }
  }
}

📖 Available Tools

1. nominate_expert - Intelligently nominate the best expert for a task
2. enhance_prompt - Enhance prompts with expert-specific frameworks
3. list_expert_roles - List all 33 expert roles
4. get_expert_capabilities - Get detailed expert information
5. execute_workflow - Execute workflow templates
6. create_custom_workflow - Create custom workflows
7. chain_workflows - Chain multiple workflows
8. list_workflows - List all workflow templates

👥 Expert Categories

• Development (6 roles): Full-Stack, Frontend, Backend, Mobile, Game, Blockchain
• Infrastructure (5 roles): DevOps, Build Systems, Platform, SRE, Systems Debug
• Data Analytics (5 roles): Data Science, BI, Statistics, Data Engineering, AI/ML
• Business Strategy (5 roles): Product, Revenue, Finance, Operations, E-commerce
• Security & Compliance (3 roles): Cybersecurity, Compliance, Database Security
• Design & UX (3 roles): UX Research, UI/UX Design, Conversion Design
• Quality & Operations (3 roles): QA, Documentation, Support
• Marketing & Growth (3 roles): Digital Marketing, Growth, Content

🚀 Production Deployment

PM2 (Recommended)

npm install -g pm2
pm2 start ecosystem.config.js
pm2 startup
pm2 save

Systemd (Linux)

sudo systemctl enable expert-roles-mcp
sudo systemctl start expert-roles-mcp

📄 License

MIT License - see file

🔗 Links

• Full Documentation
• Issue Tracker

Version: 1.0.0 | Platform: Windows, Linux, macOS | Node.js: v18+