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-proxy2.创建虚拟环境
python -m venv venv3.激活虚拟环境
窗户：
venv\Scripts\activateLinux/Mac：
source venv/bin/activate4.安装依赖项
pip install -r requirements.txt5.配置环境变量
复制示例文件：
cp .env.example .env编辑 .env 使用您的实际值（请参阅下面的OAuth配置部分）。
6.运行服务器
python server.py服务器将在 http://localhost:8000
______________________________________________________________________
OAUTH配置
要使用此服务器，您需要使用Auth0或Descope等提供程序配置OAuth。
选项A:Auth0
- Ve a auth0.com 创建帐户
- 创建新应用程序：
- 仪表盘→ 应用程序→ 创建应用 - Seleccina“机器对机器应用”
- 创建一个API：
- 仪表盘→ APIs → 创建API - 姓名： v0-proxy-api - 标识符： https://v0-proxy.example.com/api （这将是你的听证会）
- 获得你的价值观：
- OAUTH_ISSUER: https://YOUR-DOMAIN.auth0.com/ （包括端杆） - 作者_观众：TU API的“标识符”（EJ： https://v0-proxy.example.com/api)
选项B：打开
- Ve a descope.com 创建帐户
- 仪表板：
- 设置→项目→项目ID（这将是您发布者的一部分）
- 创建应用程序：
- 应用程序→ 新应用
- 获得你的价值观：
- 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密钥
- Ve a v0.dev
- 使用您的帐户登录
- Vea设置o API设置
- 生成新的API密钥
- 复制密钥并粘贴到
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 main2.在铁路上创建项目
- Ve a railway应用程序
- 创建帐户或登录
- 点击“新建项目”
- Seleccina“从GitHub仓库部署”
- 连接您的存储库
mcp-v0-proxy
3.配置环境变量
En铁路仪表板：
- 点击您的服务
- Ve a“变量”
- 添加这些变量：
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/api4.获取服务器URL
- 恩铁路，有“设置”
- 在“网络”中，它产生了一个公共领域
- 复制URL（例如：
https://mcp-v0-proxy-production.up.railway.app)
______________________________________________________________________
添加为Claude中的远程MCP连接器
在claude.ai（网站）
- Ve a claude.ai
- 单击“设置”（左下角）
- Ve a“连接器”o“MCP服务器”
- 单击en“添加自定义连接器”o“添加远程服务器”
- 介绍los datos：
- 名字: v0-proxy - 统一资源定位符: https://tu-servidor-railway.up.railway.app - 认证：OAuth
- 单击“连接”并完成OAuth流
- 一旦经过验证，连接器将准备就绪
在克劳德的手机应用程序中
- 打开克劳德的应用程序
- Ve a设置→ 连接器
- 点击en“添加远程服务器”
- 简介：
- 名字: v0-proxy - 服务器URL: https://tu-servidor-railway.up.railway.app
- 点击“连接”
- 在浏览器中完成OAUTH登录
- 返回应用程序
______________________________________________________________________
使用
连接后，您可以从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上启动
- 验证铁路仪表板上的日志
- 确保所有环境变量都已配置
- 验证端口8000是否暴露
______________________________________________________________________
安全
- 永远不要上传你的文件
.envGithub（在.gitignore) - 定期轮换您的v0.dev API密钥
- 使用OAuth进行身份验证，不要暴露公共端点
- 保持相关性更新
______________________________________________________________________
许可证
麻省理工学院
______________________________________________________________________
支持
对于问题：
- FastMCP:
- v0.dev：查看V0.dev的官方文档
- 铁路: docs.railway.app