WRLD MCP Collection

A comprehensive collection of Model Context Protocol (MCP) server configurations for WRLD Inc development environments, including Warp (WarpPreview) and VSCode integration.

🚀 Overview

This repository manages MCP server configurations for:

• GitHub - Source control and repository management
• Figma - Design file integration
• Puppeteer - Automated browser workflows
• Context7 - External data integrations
• Atlassian - Jira/Confluence integration via Rovo
• Grafana - Monitoring and observability

🏗️ Architecture

WRLD_MCP_Collection/
├── configs/           # MCP server configurations
│   ├── github/       # GitHub MCP server config
│   ├── figma/        # Figma MCP server config
│   ├── puppeteer/    # Puppeteer MCP server config
│   ├── context7/     # Context7 MCP server config
│   ├── atlassian/    # Atlassian MCP server config
│   └── grafana/      # Grafana MCP server config
├── scripts/          # Automation scripts
│   ├── deployment/   # Server deployment scripts
│   └── setup/        # Local setup scripts
├── docs/             # Documentation
└── secrets/          # 1Password Connect configs (gitignored)

🔐 Security & Secrets Management

All secrets are managed through 1Password Connect for secure credential storage and rotation.

Required Secrets

The following secrets need to be configured in 1Password:

GitHub MCP Server

• GITHUB_TOKEN - Personal Access Token with appropriate scopes
• GITHUB_ORG - Organization name (WRLDInc)

Figma MCP Server

• FIGMA_ACCESS_TOKEN - Figma API access token
• FIGMA_TEAM_ID - Your Figma team ID

Puppeteer MCP Server

• PUPPETEER_BROWSER_URL - Remote browser endpoint (if using remote execution)

Context7 MCP Server

• CONTEXT7_API_KEY - Context7 API key

Atlassian MCP Server

• ATLASSIAN_API_TOKEN - Atlassian API token
• ATLASSIAN_EMAIL - Account email
• ATLASSIAN_DOMAIN - Your Atlassian domain

Grafana MCP Server

• GRAFANA_API_KEY - Grafana API key
• GRAFANA_URL - Grafana instance URL

🛠️ Setup Instructions

Prerequisites

1. 1Password CLI installed and configured

   brew install 1password-cli
   op signin

2. Node.js (v18 or higher)

   brew install node

3. Docker (for containerized deployments)

   brew install docker

Local Development Setup

1. Clone the repository:

   git clone https://github.com/WRLDInc/WRLD_MCP_Collection.git
   cd WRLD_MCP_Collection

2. Run the setup script:

   ./scripts/setup/install.sh

3. Configure your IDE:

   • For Warp/WarpPreview: Copy configs to ~/.warp/mcp/
   • For VSCode: Install the MCP extension and configure settings

Server Deployment

For deploying to Ubuntu (22/24) or Debian 12 servers:

# Deploy to a specific server
./scripts/deployment/deploy.sh --host <server-ip> --env production

# Deploy specific MCP server
./scripts/deployment/deploy.sh --host <server-ip> --service github

📝 Configuration

Warp Integration

Add to your Warp settings:

{
  "mcp": {
    "servers": {
      "github": {
        "command": "node",
        "args": ["./configs/github/server.js"],
        "env": {
          "GITHUB_TOKEN": "op://WRLD/GitHub MCP/token"
        }
      }
    }
  }
}

VSCode Integration

Add to your VSCode settings.json:

{
  "mcp.servers": {
    "github": {
      "path": "./configs/github/server.js",
      "secrets": {
        "provider": "1password",
        "vault": "WRLD"
      }
    }
  }
}

🚢 Deployment Environments

Supported Platforms

• Ubuntu 24.04 LTS
• Ubuntu 22.04 LTS
• Debian 12

Security Considerations

• All MCP servers run in isolated containers
• Secrets are injected at runtime via 1Password Connect
• TLS/SSL encryption for all external connections
• Regular security updates via automated CI/CD

📚 Documentation

• Setup Guide
• Security Best Practices
• Troubleshooting
• API Documentation

🤝 Contributing

1. Create a feature branch
2. Make your changes
3. Test locally and on staging server
4. Submit a pull request

📄 License

Copyright © 2025 WRLD Inc. All rights reserved.

🆘 Support

For issues or questions:

• Create an issue in this repository
• Contact the WRLD DevOps team
• Check the troubleshooting guide