内容
<!-- mcp-name: io.github.doteyeso-ops/mcp-server-vibes-coded -->
# MCP服务器 - Vibes-Coded
MCP服务器，暴露 **Vibes-Coded 按次付费 x402 代理工具端点** 作为可发现的MCP工具。代理服务器在 Glama / Smithery / 官方MCP注册中心上找到该服务器，然后调用代理到 `https://vibes-coded.com/api/v1/outcomes/{slug}` 的工具。
## 功能
- 自动将目录端点注册为MCP工具（从Vibes-Coded发现中实时获取）。
- 免费试用端点无需身份验证即可工作。付费端点通过x402（HTTP 402 → 支付 → 重试）结算USDC。
- 类别：代理可靠性（状态 / 确定性 / 漂移 / 重试风暴），内存，成本控制，供应链信任和实用程序（网络搜索，JSON修复，页面Markdown）。
- 包括一个 **`pay`** 工具，返回确切的402挑战（或转发 `PAYMENT-SIGNATURE`）。
- 优先使用 **预付费** （`X-Vibes-Key`）或 **24小时通行证** （`X-Day-Pass`）而不是每次调用钱包签名。
- **人类资助界面：** https://vibes-coded.com/start （$1 USDC → 复制 `X-Vibes-Key`）。
- **运行中救援（操作员中断）：** 发送头部 `X-Operator-Notify: https://…` 在402 → 轮询 `GET /api/v1/operator-interrupt/{ois_…}` 直到 `status=funded`。
## 安装
```bash
pip install mcp-server-vibes-coded
mcp-server-vibes-coded # stdio MCP for local clients
```
**没有npm包**。请勿使用 `npx @doteyeso-ops/mcp-server-vibes-coded`。
## 主机 / Docker（Glama，Smithery）
默认（stdio — 本地客户端，MCP注册中心OCI，Glama `mcp-proxy`）：
```bash
python mcp_server.py
# 或：docker run -i --rm ghcr.io/doteyeso-ops/mcp-server-vibes-coded:1.0.3
```
HTTP模式（Smithery / 检查者）：
```bash
PORT=3000 MCP_TRANSPORT=streamable-http python mcp_server.py
# 健康检查：GET /health GET /healthz
```
Glama发布步骤：参见 [`GLAMA_RELEASE.md`](GLAMA_RELEASE.md) （Glama生成自己的镜像；使用stdio CMD，而不是HTTP）。
环境变量：
- `VIBES_ORIGIN` — API基础（默认生产Railway URL，绕过Cloudflare）
- `MCP_TRANSPORT=streamable-http` + `PORT` — 可选的HTTP模式，用于托管检查者
- `HOST` （仅HTTP模式）
## 支付
该服务器是一个发现 + 代理包装器。支付通过OpenX402（Solana USDC）在Vibes-Coded上结算。转发 `PAYMENT-SIGNATURE`，或在后端使用预付费 / 日通行证头部。
**首选（无运行时钱包）：**
1. 操作员打开 https://vibes-coded.com/start → 支付 $1 USDC → 将 `X-Vibes-Key` 粘贴到代理/MCP环境中
2. 或机器资助：`POST /api/v1/outcomes/balance/fund`
3. 运行时无密钥：`X-Operator-Notify` → 人类资助 `/start?ois=` → 轮询密钥
- 市场：https://vibes-coded.com
- 资助代理：https://vibes-coded.com/start
- 代理文档：https://vibes-coded.com/llms.txt
- 目录：https://vibes-coded.com/api/v1/outcomes/meta
- 官方连接器（OpenClaw/Hermes）：https://doteyeso-ops.github.io/vibes-coded-agent-connector/
- Glama：https://glama.ai/mcp/servers/@doteyeso-ops/mcp-server-vibes-coded
- Smithery：https://smithery.ai/servers/@doteyeso-ops/mcp-server-vibes-coded
