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

1Password CLI installed and configured
```
brew install 1password-cli
op signin
```
Node.js (v18 or higher)
```
brew install node
```
Docker (for containerized deployments)
```
brew install docker
```

Local Development Setup

Clone the repository:

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

Run the setup script:
```
./scripts/setup/install.sh
```
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

🤝 Contributing

Create a feature branch
Make your changes
Test locally and on staging server
Submit a pull request

📄 License

🆘 Support

For issues or questions:

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

MCP Servers