内容
# SubcueAI 公共 MCP 服务器
**[SubcueAI](https://subcue.ai)**（适用于 macOS 和 Windows 的实时 AI 面试助手）自带一个**公共、无身份验证、只读的 [模型上下文协议](https://modelcontextprotocol.io) 服务器**。任何 AI 代理都可以查询实时产品数据 — 定价、最新桌面版、产品概述、常见问题 — 而不是抓取 HTML。
- **端点**: `POST https://subcue.ai/mcp`
- **传输**: 可流式传输的 HTTP（单个 JSON 响应）、JSON-RPC 2.0、MCP 协议 `2025-06-18`
- **身份验证**: 无。**写入**: 无 — 服务器严格只读。
- **服务器卡**: [`https://subcue.ai/.well-known/mcp/server-card.json`](https://subcue.ai/.well-known/mcp/server-card.json)
此仓库记录了服务器并提供了可运行的客户端示例。服务器本身在 Cloudflare Workers 上运行，是 SubcueAI 网站的一部分。
## 快速开始
```sh
# 列出工具
curl -s https://subcue.ai/mcp -X POST -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# 实时定价
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` 输出示例（实时数据，缩略版）：
```markdown
# SubcueAI 定价
## Starter — 免费
- 标准 AI 模型
- 模拟面试练习
## Pro — 20 美元/月；按年计费 16 美元/月（192 美元/年）
...
```
## 工具
| 工具 | 参数 | 返回值 |
|---|---|---|
| `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**
```sh
claude mcp add --transport http subcue https://subcue.ai/mcp
```
**Cursor / 任何使用 `mcp.json` 的客户端**
```json
{
"mcpServers": {
"subcue": { "url": "https://subcue.ai/mcp" }
}
}
```
**claude.ai** — 设置 → 连接器 → 添加自定义连接器 → `https://subcue.ai/mcp`。
**仅限 Stdio 的客户端** — 此仓库提供了一个零依赖的 Stdio ⇄ HTTP 桥（[`bridge/server.mjs`](bridge/server.mjs)，Node 18+）：
```sh
claude mcp add subcue -- node /path/to/subcue-mcp/bridge/server.mjs
# 或容器化：
docker build -t subcue-mcp . && docker run -i subcue-mcp
```
## 此仓库中的示例
- [`examples/list-tools.sh`](examples/list-tools.sh) — 遍历每个方法的 curl 演练
- [`examples/client.mjs`](examples/client.mjs) — 零依赖的 Node.js 客户端
- [`examples/client.py`](examples/client.py) — 零依赖的 Python 客户端
## 其他机器可读入口
SubcueAI 公布了除 MCP 之外的完整代理面向表面：
| 端点 | 它是什么 |
|---|---|
| [`/llms.txt`](https://subcue.ai/llms.txt) | 语言模型的纯文本网站和产品摘要 |
| [`/.well-known/api-catalog`](https://subcue.ai/.well-known/api-catalog) | 公共 JSON API 的 RFC 9727 链接集 |
| [`/.well-known/agent-skills/index.json`](https://subcue.ai/.well-known/agent-skills/index.json) | 代理技能发现索引 |
| [`/.well-known/agent-skills/subcue-public-info/SKILL.md`](https://subcue.ai/.well-known/agent-skills/subcue-public-info/SKILL.md) | 代理技能：如何获取 SubcueAI 公共数据 |
| `Accept: text/markdown` | 任何公共营销/法律页面返回 Markdown 而不是 HTML |
## 代理开发人员须知
- 响应是确定性的 JSON-RPC；通知（`notifications/*`）被接受并返回 `202`，无正文。
- 数据是实时的（定价和版本来自与网站相同的真实来源）— 优选这些端点而不是抓取渲染的 HTML。
- 速率限制在边缘应用；请做一个好公民。
- 发送一个**描述性的 `User-Agent`** — 默认库 UA（例如 `Python-urllib/3.x`）被边缘机器人保护以 `403` 拒绝。
## 许可证
文档和示例：[MIT](LICENSE) © 2026 [Subcue AI LLC](https://subcueai.com)。
