Metro MCP

🚀 Metro MCP

A remote Model Context Protocol (MCP) server that interfaces with the Washington, DC, Metro (WMATA) APIs. It's designed for integration with MCP-compatible clients like Claude Desktop and can be configured to deploy on Cloudflare Workers.

🚀 Quick Start

The Metro MCP is a remote server that interfaces with WMATA APIs. It can be integrated with MCP-compatible clients and deployed on Cloudflare Workers.

✨ Features

You can ask natural questions about the Metro, including:

Real-Time Transit Information

• Check train arrivals: "When is the next Red Line train at Dupont Circle?"
• Get service alerts: "Are there any delays on the Blue Line right now?"
• Find elevator/escalator outages: "Are all the elevators working at Union Station?"

Station Information & Navigation

• Search for stations: "Where is the Smithsonian Metro station?"
• Get stations by line: "Show me all the stations on the Green Line"

Trip Planning & Accessibility

• Route planning: "How do I get from Capitol South to Bethesda?"
• Check accessibility: "Are there any elevator outages between here and National Airport?"
• Real-time predictions: "What are the next 3 trains arriving at Gallery Place?"

Service Monitoring

• Current incidents: "Any Metro delays right now?"
• Line-specific issues: "Is the Orange Line running normally?"
• Construction updates: "What stations are closed for construction?"

Geographic & System Info

• Get all stations: Complete list of Metro stations with their coordinates
• Line information: Details about all six Metro lines

📦 Installation

1. Clone this repository, paste in your own environment variables, and deploy the server. Then configure your MCP client.
2. Copy wrangler.toml.example to wrangler.toml and set your environment variables:

[vars]
WMATA_API_KEY = "your-wmata-api-key"           # Required - Get from developer.wmata.com
JWT_SECRET = "your-jwt-secret"                 # Required - Generate with: openssl rand -hex 32
GITHUB_CLIENT_ID = "your-github-client-id"     # Optional - OAuth app client ID
GITHUB_CLIENT_SECRET = "your-github-secret"    # Optional - OAuth app client secret
OAUTH_REDIRECT_URI = "https://your-domain.com/callback"  # Optional - Your callback URL

OAuth Setup (Optional)

To require users to log in to access your server, set up authentication with an OAuth provider like GitHub.

For GitHub OAuth authentication:

1. Create a GitHub OAuth app at github.com/settings/developers
2. Set Authorization callback URL to https://your-domain.com/callback
3. Set the environment variables above with your OAuth credentials

Claude Desktop Integration

Add to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "metro-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-domain.com/sse",
        "--header",
        "Authorization: Bearer your-token-here"
      ]
    }
  }
}

📚 Documentation

The MCP server interfaces with the official WMATA APIs. Visit WMATA's developer documentation for details.

• Station predictions: Real-time train arrival information
• Station information: Station names, codes, and locations
• Incidents: Service disruptions and advisories
• Elevator/escalator outages: Accessibility information

📄 License

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