VibeCode
真正的单命令MCP服务器，用于Claude Code，具有自动持久域和OAuth身份验证功能。
为什么选择VibeCode？
- ⚡ 一个命令:
vibecode start-就是这样 - 🌐 持久域：自动创建永不更改的稳定域
- 🔐 OAuth 2.1身份验证：claude.ai的内置身份验证
- 🔒 缺省巩固安全：每个会话的唯一UUID路径
- 🛠️ 零配置：智能隧道管理
- 📱 适用于所有地方：在任何设备、任何地方使用Claude Code
安装
选项1：从PyPI安装（即将推出）
pip install vibecode选项2：从Git安装（当前）
# Or install directly from git
pip install git+https://github.com/your-username/vibecode.git#subdirectory=vibecode需求
# Install cloudflared (macOS)
brew install cloudflared
# Or install cloudflared (Linux/Windows)
# See: https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation快速开始
# One-time setup (optional, for persistent domain)
cloudflared tunnel login
# Start everything
vibecode start首次运行：获取一个稳定的域，如 https://vibecode-123456.cfargotunnel.com\ 每次跑步后：自动使用同一域名！
将URL复制到Claude.ai MCP配置中一次-它永远不会改变。
将VibeCode与Claude.ai结合使用
步骤1：启动服务器
vibecode start --quick从终端输出复制公共URL（例如。， https://example.trycloudflare.com/uuid)
查询可用工具
# Check what tools are available
curl -X POST http://localhost:8300/ \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
# Or use the included script
python query_tools.py --info预期： 17工具 包括 claude_code （Claude Code CLI集成）
步骤2：访问Claude.ai连接器
- 首选 claude.ai/设置/连接器
- 点击 “连接器” 左侧边栏（以红色突出显示）
- 点击 “添加自定义连接器” 底部的按钮
步骤3：配置VibeCode连接器
- 在“添加自定义连接器”对话框中：
- 名字：输入 vibecode macbookv1 （或您喜欢的任何名称） - 统一资源定位符：粘贴您的VibeCode服务器URL（例如。， https://sign-returned-poultry-introduction.trycloudflare.com/)
- 重要：确保使用 仅限基本URL
- 您将看到一条安全警告：“此连接器尚未经过Anthropic验证”
- 点击 “添加” 继续
步骤4：连接到您的VibeCode服务器
- 添加连接器后，您将看到它与您的自定义名称一起列出
- 点击 “连接” VibeCode连接器旁边的按钮
- Claude.ai现在将与您的MCP服务器建立连接
所得
连接后，Claude.ai可以：
- 读取和写入文件 在您允许的目录中
- 运行命令 在你允许的情况下
- 执行代码 并查看结果
- 访问您的开发环境 通过MCP协议
示例用法
连接后，您可以要求Claude：
using claude code mcp agent, write a simple helloworld python app克劳德将：
- 创建Python文件
- 编写Hello World代码
- 执行它并显示结果
命令
# Main command (automatically uses persistent domain if available)
vibecode start # Smart tunnel selection
# Options
vibecode start --quick # Force quick tunnel (random domain)
vibecode start --no-tunnel # Local only
vibecode start --port 9000 # Custom port
# Setup
vibecode setup # One-time setup guide运作原理
无需设置 （只是工作）：
vibecode start # → https://abc-random.trycloudflare.com (changes each time)一次性设置 （推荐）：
cloudflared tunnel login # One time only
vibecode start # → https://vibecode-123456.cfargotunnel.com (same every time)VibeCode会自动执行以下操作：
- ✅ 检测您是否已通过Cloudflare的身份验证
- ✅ 首次运行时创建持久隧道
- ✅ 在后续运行中重用相同的隧道（和域）
- ✅ 如果未通过身份验证，则返回快速隧道
服务器配置
持久隧道与快速隧道
- 快速隧道 (
--quick)：使用随机域快速设置，停止后过期 - 持久隧道 （默认）：重新启动后仍保持稳定的域
自定义路径
配置Claude可以访问的目录：
vibecode start --allowed-paths /path/to/project --allowed-paths /another/path无身份验证模式
仅用于测试（不建议用于生产）：
vibecode start --no-auth地方发展
在没有隧道的情况下进行当地开发：
vibecode start --no-tunnel --port 8300高级用法
# Get setup help
vibecode setup # Simple setup guide
vibecode tunnel guide # Detailed tunnel guide
# Tunnel management
vibecode tunnel list # List your tunnels
vibecode start --tunnel my-mcp # Use specific tunnelOAuth 2.1身份验证
VibeCode通过动态客户端注册（DCR）实现了OAuth 2.1，与Claude.ai无缝集成：
- 授权服务器元数据:
/.well-known/oauth-authorization-server - 动态客户端注册:
/register - 授权端点:
/authorize - 令牌端点:
/token - PKCE 支持：所有客户都需要
- 公共客户：不需要客户端机密
安全功能
- 基于UUID的路径 每节课
- OAuth 2.1合规性 动态客户端注册
- Cloudflare隧道加密 用于安全通信
- 目录访问控制 通过allow_paths配置
故障排除
连接问题
如果Claude.ai无法连接：
- 检查您的服务器是否正在运行:
# Look for this output
📡 Public URL: https://your-domain.trycloudflare.com/uuid- 验证OAuth端点 可访问：
curl https://your-domain.trycloudflare.com/.well-known/oauth-authorization-server- 检查服务器日志 对于任何错误消息
常见问题
- 404错误：添加连接器时，请确保使用基本URL（不带UUID）
- 连接超时：您的隧道可能已过期-请重新启动
vibecode start - 权限不足：检查您的
allowed_paths配置
技术细节
MCP协议支持
VibeCode实现了完整的MCP（模型上下文协议）规范：
- JSON-RPC 2.0消息传递
- 服务器发送事件（SSE）传输
- 工具调用和资源访问
- 实时双向通信
OAuth 2.1合规性
完整的OAuth 2.1实现，包括：
- RFC 8414：授权服务器元数据
- RFC 9728：受保护的资源元数据
- RFC 7662：令牌自检
- RFC 7009：令牌撤销
- 动态客户端注册（DCR）
需求
- Python 3.10+
cloudflaredCLI(安装指南)
发展
有关贡献者，请参阅 CLAUDE.md 用于技术文档和开发设置。
许可证
麻省理工学院