MCP V0 Proxy

MCP v0.dev代理服务器

带有OAuth身份验证的远程MCP服务器充当V0.dev API的代理。允许从仅支持OAuth远程MCP的移动设备使用V0.dev。

特点

• OAuth身份验证（与Auth0、Descope等兼容）
• 暴露工具 generate_ui 生成UI代码
• 针对v0.dev API的安全代理
• 鲁棒错误处理
• 准备部署到铁路

要求

• Python 3.10以上
• 在V0.dev中使用API密钥帐户
• OAuth供应商（Auth0、Descope等）

______________________________________________________________________

本地安装

1.克隆存储库

cd mcp-v0-proxy

2.创建虚拟环境

python -m venv venv

3.激活虚拟环境

窗户：

venv\Scripts\activate

Linux/Mac：

source venv/bin/activate

4.安装依赖项

pip install -r requirements.txt

5.配置环境变量

复制示例文件：

cp .env.example .env

编辑 .env 使用您的实际值（请参阅下面的OAuth配置部分）。

6.运行服务器

python server.py

服务器将在 http://localhost:8000

______________________________________________________________________

OAUTH配置

要使用此服务器，您需要使用Auth0或Descope等提供程序配置OAuth。

选项A:Auth0

1. Ve a auth0.com 创建帐户
2. 创建新应用程序：

- 仪表盘→ 应用程序→ 创建应用 - Seleccina“机器对机器应用”

1. 创建一个API：

- 仪表盘→ APIs → 创建API - 姓名： v0-proxy-api - 标识符： https://v0-proxy.example.com/api （这将是你的听证会）

1. 获得你的价值观：

- OAUTH_ISSUER: https://YOUR-DOMAIN.auth0.com/ （包括端杆） - 作者_观众：TU API的“标识符”（EJ： https://v0-proxy.example.com/api)

选项B：打开

1. Ve a descope.com 创建帐户
2. 仪表板：

- 设置→项目→项目ID（这将是您发布者的一部分）

1. 创建应用程序：

- 应用程序→ 新应用

1. 获得你的价值观：

- OAUTH_ISSUER: https://api.descope.com/YOUR-PROJECT-ID - 作者_观众：您的应用程序的观众/标识符

设置为 .env

编辑您的文件 .env:

# API Key de v0.dev
V0_API_KEY=tu_api_key_de_v0

# Endpoint real de v0.dev (ACTUALIZA ESTO)
# Consulta la documentación oficial de v0.dev para el endpoint correcto
V0_ENDPOINT=https://api.v0.dev/generate

# OAuth desde tu proveedor
OAUTH_ISSUER=https://tu-dominio.auth0.com/
OAUTH_AUDIENCE=https://v0-proxy.example.com/api

获取v0.dev的API密钥

1. Ve a v0.dev
2. 使用您的帐户登录
3. Vea设置o API设置
4. 生成新的API密钥
5. 复制密钥并粘贴到 V0_API_KEY 恩 .env

关于V0_Endpoint的重要信息： 该代码中的端点是占位符。您必须查看V0.dev的官方文档才能获得API的实际端点。在您的文档中搜索API或Endpoints部分以获得正确的URL。

______________________________________________________________________

铁路部署

1.发布GitHub

git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/TU-USUARIO/mcp-v0-proxy.git
git push -u origin main

2.在铁路上创建项目

1. Ve a railway应用程序
2. 创建帐户或登录
3. 点击“新建项目”
4. Seleccina“从GitHub仓库部署”
5. 连接您的存储库 mcp-v0-proxy

3.配置环境变量

En铁路仪表板：

1. 点击您的服务
2. Ve a“变量”
3. 添加这些变量：

V0_API_KEY=tu_api_key_real
V0_ENDPOINT=https://api.v0.dev/generate
OAUTH_ISSUER=https://tu-dominio.auth0.com/
OAUTH_AUDIENCE=https://v0-proxy.example.com/api

4.获取服务器URL

1. 恩铁路，有“设置”
2. 在“网络”中，它产生了一个公共领域
3. 复制URL（例如： https://mcp-v0-proxy-production.up.railway.app)

______________________________________________________________________

添加为Claude中的远程MCP连接器

在claude.ai（网站）

1. Ve a claude.ai
2. 单击“设置”（左下角）
3. Ve a“连接器”o“MCP服务器”
4. 单击en“添加自定义连接器”o“添加远程服务器”
5. 介绍los datos：

- 名字: v0-proxy - 统一资源定位符: https://tu-servidor-railway.up.railway.app - 认证：OAuth

1. 单击“连接”并完成OAuth流
2. 一旦经过验证，连接器将准备就绪

在克劳德的手机应用程序中

1. 打开克劳德的应用程序
2. Ve a设置→ 连接器
3. 点击en“添加远程服务器”
4. 简介：

- 名字: v0-proxy - 服务器URL: https://tu-servidor-railway.up.railway.app

1. 点击“连接”
2. 在浏览器中完成OAUTH登录
3. 返回应用程序

______________________________________________________________________

使用

连接后，您可以从Claude使用该工具：

Genera un botón de React con estilos Tailwind

克劳德会自动调用该工具 generate_ui 在您的提示下，服务器将通过返回生成的代码向v0.dev发出请求。

______________________________________________________________________

项目结构

mcp-v0-proxy/
├── server.py          # Servidor MCP principal con OAuth
├── requirements.txt   # Dependencias Python
├── .env.example       # Plantilla de variables de entorno
└── README.md          # Esta documentación

______________________________________________________________________

解决问题

错误：“需要V0_API_KEY环境变量”

确保您已经创建了文件 .env API密钥更正。

错误：“v0.dev API错误：401”

您的V0.dev API密钥无效或已过期。在v0.dev中生成新的。

错误：“连接到v0.dev时发生网络错误”

验证终结点 V0_ENDPOINT 是正确的。查看V0.dev的文档。

OAuth错误：“颁发者无效”

检查 OAUTH_ISSUER 确定条件 / 成为您的OAuth提供商的完整URL。

服务器没有在Railway上启动

1. 验证铁路仪表板上的日志
2. 确保所有环境变量都已配置
3. 验证端口8000是否暴露

______________________________________________________________________

安全

• 永远不要上传你的文件 .env Github（在 .gitignore)
• 定期轮换您的v0.dev API密钥
• 使用OAuth进行身份验证，不要暴露公共端点
• 保持相关性更新

______________________________________________________________________

许可证

麻省理工学院

______________________________________________________________________

支持

对于问题：

• FastMCP:
• v0.dev：查看V0.dev的官方文档
• 铁路: docs.railway.app