SubcueAI

SubcueAI 公共 MCP 服务

mcp-name: io.github.Subcue/subcue-mcp

SubcueAI（适用于 macOS 和 Windows 的实时 AI 面试助手）提供公开、无需身份验证、只读的 Model Context Protocol 服务。任何 AI Agent 都可以查询实时产品数据——定价、最新桌面版本、产品概览、常见问题解答——而无需抓取 HTML。

• 端点：POST https://subcue.ai/mcp
• 传输方式：streamable-http（单个 JSON 响应）、JSON-RPC 2.0、MCP 协议 2025-06-18
• 身份验证：无。写入操作：无——该服务严格只读。
• 服务卡片：https://subcue.ai/.well-known/mcp/server-card.json

此仓库介绍该服务，并提供可直接运行的客户端示例。服务本身作为 SubcueAI 网站的一部分运行在 Cloudflare Workers 上。

快速开始

# List tools
curl -s https://subcue.ai/mcp -X POST -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Live pricing
curl -s https://subcue.ai/mcp -X POST -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_pricing"}}'

get_pricing 输出示例（实时数据，已删节）：

# SubcueAI Pricing

## Starter — free
- Standard AI model
- Mock interview practice

## Pro — $20/mo; $16/mo when billed yearly ($192/yr)
...

工具

工具	参数	返回内容
get_pricing	—	当前订阅方案和定价（Markdown）
get_latest_version	platform（可选，例如 macos-arm64、windows-x64）	最新桌面应用版本、发布日期、下载 URL

资源

URI	内容
subcue://overview	SubcueAI 的介绍、主要功能、链接（Markdown）
subcue://faq	常见问题解答（Markdown）

请按照 MCP 规范使用 resources/list / resources/read。

连接常用客户端

Claude Code

claude mcp add --transport http subcue https://subcue.ai/mcp

Cursor / 任何使用 mcp.json 的客户端

{
  "mcpServers": {
    "subcue": { "url": "https://subcue.ai/mcp" }
  }
}

claude.ai — Settings → Connectors → Add custom connector → https://subcue.ai/mcp。

仅支持 Stdio 的客户端 — 此仓库提供一个零依赖的 stdio ⇄ HTTP 桥接程序（bridge/server.mjs，Node 18+）：

claude mcp add subcue -- node /path/to/subcue-mcp/bridge/server.mjs
# or containerised:
docker build -t subcue-mcp . && docker run -i subcue-mcp

此仓库中的示例

• examples/list-tools.sh — 使用 curl 演示每种方法
• examples/client.mjs — 零依赖 Node.js 客户端
• examples/client.py — 零依赖 Python 客户端

其他机器可读入口

SubcueAI 除 MCP 外，还提供完整的面向 Agent 的接口：

端点	说明
/llms.txt	面向大模型的纯文本网站和产品简介
/.well-known/api-catalog	公共 JSON API 的 RFC 9727 linkset
/.well-known/agent-skills/index.json	Agent Skills 发现索引
/.well-known/agent-skills/subcue-public-info/SKILL.md	Agent 技能：如何获取 SubcueAI 公共数据
Accept: text/markdown	任何公开的营销或法律页面都会返回 Markdown，而非 HTML

给 Agent 开发者的说明

• 响应为确定性的 JSON-RPC；通知（notifications/*）会被接受，并返回不含正文的 202。
• 数据为实时数据（定价和版本与网站使用同一数据源）——请优先使用这些端点，而非抓取渲染后的 HTML。
• 边缘节点会实施速率限制；请合理使用。
• 请发送描述性的 User-Agent——默认库的 UA（例如 Python-urllib/3.x）会被边缘机器人防护拦截，并返回 403。

许可证

文档和示例：MIT © 2026 Subcue AI LLC。