Nodeflare

Nodeflare

Deploy, manage, and scale MCP servers — Vercel for MCP.

[](https://opensource.org/licenses/MIT)

🌐 Try it now → nodeflare.tech

What is Nodeflare?

Nodeflare is an MCP (Model Context Protocol) hosting platform that lets you deploy any MCP server with just a GitHub URL. It automatically converts stdio-based MCP servers to the Streamable HTTP transport, making them accessible from remote AI assistants like Claude.

Key Features:

• 🚀 One-click deployment — Just paste a GitHub URL
• 🔄 Automatic stdio→Streamable HTTP conversion — Works with any MCP server
• 🔐 Built-in authentication — API keys, OAuth 2.0, scoped permissions
• 📊 Access logging — Full audit trail for enterprise compliance
• 🌍 Global edge deployment — Powered by Fly.io

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                         Nodeflare                               │
├─────────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐  │
│  │   Next.js   │  │  API Server │  │     Proxy Gateway       │  │
│  │  Frontend   │──│   (Axum)    │──│   (Rate Limit, Auth)    │  │
│  └─────────────┘  └─────────────┘  └─────────────────────────┘  │
│         │                │                      │               │
│         │                │                      │               │
│  ┌──────┴────────────────┴──────────────────────┴──────────┐   │
│  │                    PostgreSQL + Redis                    │   │
│  │                    (Neon + Upstash)                      │   │
│  └──────────────────────────────────────────────────────────┘   │
│         │                                                       │
│  ┌──────┴──────┐                                               │
│  │   Builder   │───────────────────────────────────────────────┤
│  │   Worker    │         Build & Deploy                        │
│  └─────────────┘                                               │
│         │                                                       │
│  ┌──────┴──────────────────────────────────────────────────┐   │
│  │              Fly.io Machines (Container Runtime)         │   │
│  │  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐    │   │
│  │  │ MCP Srv │  │ MCP Srv │  │ MCP Srv │  │ MCP Srv │    │   │
│  │  └─────────┘  └─────────┘  └─────────┘  └─────────┘    │   │
│  └──────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘

Tech Stack

• Backend: Rust (Axum, SQLx, Tokio)
• Frontend: Next.js 15, TypeScript, Tailwind CSS
• Database: Neon (Serverless PostgreSQL)
• Cache/Queue: Upstash (Serverless Redis)
• Container Runtime: Fly.io Machines
• Billing: Stripe

Project Structure

nodeflare/
├── crates/
│   ├── api/            # Main API server (Axum)
│   ├── auth/           # JWT, OAuth, API keys, encryption
│   ├── billing/        # Stripe billing
│   ├── builder/        # Build worker (Docker, Fly.io)
│   ├── common/         # Shared types, config, errors
│   ├── container/      # Container runtime abstraction
│   ├── db/             # Database models & repositories
│   ├── email/          # Email sending (Resend)
│   ├── github/         # GitHub App integration
│   ├── mcp-runtime/    # MCP protocol types
│   ├── proxy/          # MCP Proxy gateway
│   └── queue/          # Job definitions
├── apps/
│   └── web/            # Next.js frontend
├── migrations/         # Database migrations
└── docker/             # Dockerfiles

Getting Started

Prerequisites

• Rust 1.75+
• Node.js 20+
• Docker & Docker Compose

Local Development

1. Clone and setup

git clone https://github.com/nodeflare-dev/nodeflare.git
cd nodeflare
cp .env.example .env

1. Setup Neon (PostgreSQL)

• Create an account at neon.tech
• Create a new project
• Copy the connection string to .env:

`` DATABASE_URL=postgresql://user:pass@ep-xxx.region.aws.neon.tech/dbname?sslmode=require ``

1. Setup Upstash (Redis)

• Create an account at upstash.com
• Create a new Redis database
• Copy the connection string to .env:

`` REDIS_URL=rediss://default:xxx@xxx.upstash.io:6379 ``

1. Configure environment variables

Set GitHub OAuth, Fly.io, and encryption keys in .env (see Configuration section below)

1. Run database migrations

cargo install sqlx-cli
sqlx migrate run

1. Start backend services

# Terminal 1: API server
cargo run --bin mcp-api

# Terminal 2: Proxy gateway
cargo run --bin mcp-proxy

# Terminal 3: Builder worker
cargo run --bin mcp-builder

1. Start frontend

cd apps/web
npm install
npm run dev

1. Open in browser

Navigate to http://localhost:3000

Configuration

Required

| Variable | Description | |----------|-------------| | DATABASE_URL | PostgreSQL connection string | | REDIS_URL | Redis connection string | | JWT_SECRET | JWT signing secret (64+ bytes) | | ENCRYPTION_KEY | AES-256 key for secrets (32 bytes, base64) | | GITHUB_CLIENT_ID | GitHub OAuth App client ID | | GITHUB_CLIENT_SECRET | GitHub OAuth App client secret | | GITHUB_APP_ID | GitHub App ID for repo access | | GITHUB_APP_PRIVATE_KEY | GitHub App private key (PEM) | | FLY_API_TOKEN | Fly.io API token for deployments |

Stripe (Billing)

| Variable | Description | |----------|-------------| | STRIPE_SECRET_KEY | Stripe API secret key | | STRIPE_WEBHOOK_SECRET | Stripe webhook secret | | APP_URL | App URL for Stripe redirects |

Email (Resend)

| Variable | Description | |----------|-------------| | RESEND_API_KEY | Resend API key | | EMAIL_FROM | Sender email address |

Generate Keys

# JWT Secret
openssl rand -base64 64

# Encryption Key
openssl rand -base64 32

Deployment

Production (Fly.io)

# API
fly deploy -c fly.api.toml

# Proxy
fly deploy -c fly.proxy.toml

# Web
fly deploy -c fly.web.toml

MCP Proxy

The proxy gateway handles MCP requests via subdomain-based routing:

POST https://{server-slug}.nodeflare.tech/mcp
Authorization: Bearer {access-token}

Example: If server slug is my-notion-mcp:

https://my-notion-mcp.nodeflare.tech/mcp

Features:

• Subdomain-based routing — Clean URLs like Vercel
• Access token / OAuth authentication
• Rate limiting (sliding window)
• Request logging
• Tool-level permissions

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: nodeflare-dev
• Source: nodeflare-dev/nodeflare
• License: MIT
• Homepage: https://nodeflare.tech/

Install and usage instructions live in the source repository linked above.