Vice City Hub

Name: Vice City Hub
Author: vicecityhub

远程服务

vicecityhub.github.io游戏娱乐0今天更新

代码仓库访问官网

关于 Vice City Hub

Vice City Hub 是 GTA VI 粉丝站，提供面向 Agent 的 API，可访问新闻、商品目录、角色扮演服务器数据、搜索和购买功能。其 MCP 与 REST 接口结合发现信息流、锁定价格的报价、幂等订单和由人工设定的支出限额。

主要功能

01访问新闻、商品目录和 RP 数据
02搜索与锁价报价
03支持 PayPal 或稳定币付款的幂等订单
04由人工管理的支出授权
05提供 17 个工具的 MCP 服务
06Agent 发现文件与静态信息流

适用场景

01查找 GTA VI 新闻、商品或 RP 服务器列表
02在 Agent 下单前获取报价
03按支出授权提交并跟踪订单
04通过 MCP 连接 Agent 或读取生成的数据流

MCP 相关

Agent API 提供无状态 Streamable HTTP MCP 服务，包含 17 个工具，用于访问商品目录、新闻、RP 数据、搜索、报价、订单和购买意向。MCP 是 Agent 可使用的接口之一，此外还提供 REST。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://lpglkglhjdqnktybksth.supabase.co/functions/v1/agent-api/mcp

一键复制安装命令

Claude CodeTerminal

claude mcp add --transport http vicecityhub-vicecityhub https://lpglkglhjdqnktybksth.supabase.co/functions/v1/agent-api/mcp

Cursor.cursor/mcp.json

{"mcpServers":{"vicecityhub-vicecityhub":{"type":"http","url":"https://lpglkglhjdqnktybksth.supabase.co/functions/v1/agent-api/mcp"}}}

在 Cursor 中打开

VS Code.vscode/mcp.json

{"servers":{"vicecityhub-vicecityhub":{"type":"http","url":"https://lpglkglhjdqnktybksth.supabase.co/functions/v1/agent-api/mcp"}}}

在 VS Code 中打开

Claude Desktopclaude_desktop_config.json

{"mcpServers":{"vicecityhub-vicecityhub":{"type":"http","url":"https://lpglkglhjdqnktybksth.supabase.co/functions/v1/agent-api/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json

{"mcpServers":{"vicecityhub-vicecityhub":{"serverUrl":"https://lpglkglhjdqnktybksth.supabase.co/functions/v1/agent-api/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址

Streamable HTTPhttps://lpglkglhjdqnktybksth.supabase.co/functions/v1/agent-api/mcp需要授权

工具

详细介绍

Vice City Hub 🌴 — v12「向 Agent 开放」

面向人类和 AI Agent 的 GTA VI 粉丝中心。为人类提供霓虹风格 UI，为机器提供 MCP + REST + llms.txt + 安全的自动购买功能。

线上地址： https://vicecityhub.github.io/vicecityhub · Agent 文档： /llms.txt · Agent 控制台： /agents.html

v12 新增内容

层	内容	位置
Agent API（REST）	商品目录、新闻、RP 数据、搜索、报价、订单、意向	`supabase/functions/agent-api/`
MCP 服务	17 个工具，无状态的可流式 HTTP	`…/agent-api/mcp`
发现机制	`llms.txt`、`llms-full.txt`、`.well-known/{agent.json,mcp.json,api-catalog,ai-plugin.json,security.txt}`、`openapi.json`	生成到 → `public/`
静态 Feed	`data/{news,catalog,rp-*}.json` + 清单 `data/index.json`	生成到 → `public/data/`
各页面 SEO/Agent 标记	`<link>` 提示、一个 JSON-LD `@graph`、`<noscript>` 内容	`vite-plugins/agent-surface.ts`
Agent 购买	价格锁定报价 → 幂等订单 → PayPal 或链上稳定币；由人类设置支出授权	`orders.ts`、`verify.ts`、`owner.ts`
人类控制台	创建/撤销有支出限额的密钥、浏览商品目录、跟踪订单	`src/pages/Agents.tsx`

人类仍可使用完整的霓虹风格 UI（每个页面都是 React SPA）。人类使用体验没有任何删减。

唯一事实来源

site.config.json——包含名称、URL、页面列表（标题、描述、优先级、Feed）。生成器、Vite 插件、llms.txt、站点地图和所有 JSON-LD 均从中读取。添加页面 → 在此处添加一条配置。

构建流水线

npm run build
 ├─ prebuild  scripts/gen-agent-surface.mjs   live API → public/{llms*.txt, openapi.json, sitemap.xml, .well-known/*, data/*}
 ├─ tsc -b
 └─ vite build   (agentSurface plugin injects discovery links + JSON-LD + <noscript> into every HTML entry)

生成器不会导致构建失败：如果 API 无法访问，则保留之前生成的文件（使用 --strict 可改为失败）。

CI（.github/workflows/deploy.yml）会在推送时、手动触发时，以及新闻 Agent 运行后每隔 6 小时重新构建，以保持 Feed 最新；随后验证 Agent 文件是否存在于 dist/ 中。

项目结构

site.config.json            ← edit pages/URLs here
vite-plugins/agent-surface.ts
scripts/
  gen-agent-surface.mjs     ← llms.txt, .well-known, feeds, sitemap
  test-agent-api.mjs        ← 30-check safe smoke test (never moves money)
  news-agent.mjs            ← scheduled news ingestion
  selftest-verify.mjs       ← on-chain verifier self-test
public/                     ← robots.txt + generated agent files (committed so Pages works even if generation fails)
src/{pages,components,lib,rp-hub}
supabase/functions/{agent-api,paypal-checkout,printful-hub,link-preview,…}
docs/legacy/                ← old one-off notes/scripts (kept, not used)

Agent 购买协议（简版）

POST /v1/agents/register → 获取密钥（每笔订单 $100、每天 $250）——也可以由人类在控制台创建额度更高的授权。
POST /v1/quotes → 锁定价格 15 分钟。
POST /v1/orders + Idempotency-Key → 返回 next_action（PayPal approve_url 或指定金额的稳定币转账）。
加密货币（无需 PayPal，完全自动）： 精确转入 amount_due 数量的 USDT/USDC。pg_cron 每分钟运行一次对账器（/v1/internal/reconcile）：它会根据唯一金额标签查找转账，在链上验证后将订单标记为 paid；若为商品订单，还会提交 Printful 订单（设置 PRINTFUL_AUTO_CONFIRM=0 可将其保留为草稿）。Printful 调用失败时，对账器会重试。payment-proof 是可选的快捷方式。PayPal：执行 capture → 轮询 GET /v1/orders/{id}/status，直到状态为 paid。

合作伙伴商品和社区服务器等第三方列表仅支持意向提交——Hub 不会托管相关资金。

开发

npm ci
npm run dev            # Vite
npm run gen:agent      # regenerate agent surface
npm run typecheck
npm run test:agent     # smoke-test the live Agent API
npm run build

部署边缘函数：npx supabase functions deploy agent-api --no-verify-jwt --use-api

已知平台限制（GitHub Pages 项目站点）

robots.txt、llms.txt 和 /.well-known/* 会在 /vicecityhub/ 下提供，而不是在主机根目录。爬虫和一些 Agent 会访问 https://vicecityhub.github.io/robots.txt（根目录）。如需完全符合规范的发现机制，请使用自定义域名，或从 vicecityhub.github.io 用户站点仓库发布相同文件。Agent API 本身（Supabase）会从自身根目录提供 /v1 索引、OpenAPI 和 MCP，因此无论如何都可被发现。