About Fastmcp Proxy Vercel
Fastmcp Proxy Vercel is an MCP server in the Browser category.
Install
git clone https://github.com/orius123/fastmcp-proxy-vercelThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Fastmcp Proxy Vercel
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
FastMCP Descope Proxy
Add Descope authentication to any MCP server without modifying its code.
Use Case
You have an MCP server running somewhere (your own infrastructure, cloud function, etc.) and want to add OAuth authentication via Descope's Agentic Identity Hub—without changing your server code.
Deploy this proxy, point it at your MCP server, and clients authenticate through Descope before reaching your server.
Architecture
┌─────────────┐ ┌─────────────────┐ ┌─────────┐ ┌────────────────┐
│ │ │ │ │ │ │ │
│ MCP Client │────▶│ This Proxy │────▶│ Descope │ │ Your MCP │
│ (Claude) │ │ (Vercel) │ │ Auth │ │ Server │
│ │◀────│ │◀────│ │ │ │
└─────────────┘ └────────┬────────┘ └─────────┘ └────────────────┘
│ ▲
│ (after authentication) │
└──────────────────────────────────────┘
Quick Start
1. Deploy to Vercel
Click the "Deploy with Vercel" button above and configure:
| Variable | Value |
|---|---|
DESCOPE_CONFIG_URL |
Your Descope MCP Server well-known URL |
TARGET_MCP_SERVER_URL |
URL of your existing MCP server |
2. Configure Descope
- Go to Descope Console → MCP Servers
- Create a new MCP Server with DCR enabled
- Set the Resource URL to your Vercel deployment URL
- Copy the Well-Known URL for
DESCOPE_CONFIG_URL
3. Connect Your Client
Point your MCP client (Claude Desktop, Cursor, etc.) to your Vercel deployment URL. The proxy handles OAuth automatically.
Configuration
| Variable | Required | Description |
|---|---|---|
DESCOPE_CONFIG_URL |
Yes | Your Descope MCP Server well-known URL |
TARGET_MCP_SERVER_URL |
Yes | URL of your MCP server to proxy |
TARGET_TOKEN |
No | Bearer token if your target server requires auth |
SERVER_URL |
No | Auto-detected on Vercel |
How It Works
- Client connects to the proxy
- Proxy redirects to Descope for OAuth authentication
- After auth, proxy forwards all requests to your target MCP server
- Target server tools are exposed with a
target_prefix
Example: If your server has a get_weather tool, clients see target_get_weather.
Local Development
Testing the Proxy
A sample target_server.py is included for local testing only:
# Terminal 1: Run mock target server (for testing only)
TARGET_API_TOKEN="test-secret" uv run fastmcp run target_server.py --transport http --port 9000
# Terminal 2: Run proxy
DESCOPE_CONFIG_URL="your-url" \
TARGET_MCP_SERVER_URL="http://localhost:9000/mcp" \
TARGET_TOKEN="test-secret" \
uv run fastmcp run api/index.py --transport http --port 8000
In production, TARGET_MCP_SERVER_URL points to your real MCP server.
Running Without Vercel
pip install -r requirements.txt
fastmcp run api/index.py --transport http --port 8000
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.