upriver

Upriver MCP

为 AI 应用提供创作者、受众、品牌、趋势和赞助的实时背景信息。

关于 Upriver

Upriver 提供一个 API，将线上动态转化为 AI 应用的实时可靠背景信息。它提供有证据支持的信号——每条信号都有真实来源佐证，涵盖：

• 创作者 — 相关创作者及其档案
• 受众 — 人物画像、兴趣、语言和幽默风格
• 品牌 — 品牌及人们对它们的讨论
• 产品 — 产品提及和使用场景
• 趋势 — 正受到关注的话题和形式
• 赞助 — 品牌与创作者之间的关系及合作展示

此仓库是 Upriver 的 模型上下文协议（MCP） 服务所在地，可将这些背景信息提供给任何兼容 MCP 的 AI 助手或 Agent。

连接

这是一个托管的远程服务——无需安装或运行任何内容。所有客户端均可通过 OAuth 登录。 Claude Code、Cursor、VS Code、 Cline、Windsurf、Codex CLI、Goose 和 Zed 支持 X-API-Key 标头；但 Claude 和 ChatGPT 的 连接器界面不支持，它们只能使用 OAuth。

Claude Code（CLI）

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

若要使用 API 密钥而非 OAuth，请将其作为标头传入：

claude mcp add --transport http upriver https://mcp.upriver.ai/mcp \
  --header "X-API-Key: YOUR_UPRIVER_API_KEY"

Cursor

将以下内容添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目级），然后在设置 → 工具与集成中连接并登录：

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

若要使用 API 密钥进行身份验证，请添加 "headers": { "X-API-Key": "YOUR_UPRIVER_API_KEY" }。

VS Code（GitHub Copilot）

VS Code 使用不同的结构——顶层为 servers，且必须包含 "type": "http"。 将以下内容添加到 .vscode/mcp.json（或运行 MCP: Add Server）：

{ "servers": { "upriver": { "type": "http", "url": "https://mcp.upriver.ai/mcp" } } }

若要使用 API 密钥进行身份验证，请添加 "headers": { "X-API-Key": "YOUR_UPRIVER_API_KEY" }。

Claude Desktop 和 claude.ai

在 Claude 中，前往自定义 → 连接器 → “+” → 添加自定义连接器，将其命名为 Upriver，粘贴 https://mcp.upriver.ai/mcp，然后点击连接并登录。 （Claude 的连接器仅支持 OAuth——没有填写 API 密钥的字段，也不要在 claude_desktop_config.json 中添加原始 url 条目；桌面应用会拒绝此配置。）

Cline

使用远程服务选项卡（传输方式：Streamable HTTP），或编辑 cline_mcp_settings.json——必须包含 type 字段，否则 Cline 会回退到旧版 SSE 并导致连接失败：

{ "mcpServers": { "upriver": { "type": "streamableHttp", "url": "https://mcp.upriver.ai/mcp" } } }

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json——Windsurf 使用的字段是 serverUrl：

{ "mcpServers": { "upriver": { "serverUrl": "https://mcp.upriver.ai/mcp" } } }

codex mcp add upriver --url https://mcp.upriver.ai/mcp --header X-API-Key=YOUR_UPRIVER_API_KEY

extensions:
  upriver:
    type: streamable_http
    uri: https://mcp.upriver.ai/mcp
    enabled: true
    headers:
      X-API-Key: "${UPRIVER_API_KEY}"

{ "context_servers": { "upriver": { "url": "https://mcp.upriver.ai/mcp", "headers": { "X-API-Key": "YOUR_UPRIVER_API_KEY" } } } }

其他 MCP 客户端

大多数客户端使用上文 Cursor 的配置格式（mcpServers + url，可选 headers）。 对于会读取安装清单的 Agent，请参阅 llms-install.md。

JetBrains IDE： MCP 可以正常工作，但该 IDE 目前会丢弃自定义请求标头， 且尚不支持远程服务的 OAuth，因此目前无法通过 Upriver 的 X-API-Key 身份验证进行连接—— 等 JetBrains 发布修复后，我们会将其列入支持列表。

当前提供的工具

MCP 服务目前公开了 Upriver 的爆发式话题——在科技、体育和政治领域在线上获得关注的新兴话题，每个话题都会返回可靠的来源引文，让模型基于真实证据进行推理，而不是猜测。

这两个工具均为只读。每个工具最多返回 limit 个话题（默认值为 10，最大值为 25），每个话题最多附带 5 条来源引文；若当前页面之外还有更多话题，则会返回 has_more 标记。

breakout_search_topics

按关键词搜索爆发式话题。

breakout_list_topics

浏览当前正在获得关注的爆发式话题。

每个话题都包含名称、领域、生命周期状态、势头信号，以及最重要的引文（标题、URL、来源类别和发布时间）。

更多内容即将推出

爆发式话题是 Upriver API 首批以 MCP 工具形式推出的功能。完整 API（创作者、受众、品牌、产品、趋势和赞助）已记录在 docs.upriver.ai，我们正陆续将这些端点推出为 MCP 工具。新工具发布时，请关注此代码库。

访问

Upriver MCP 访问权限按账户开通。请在 dashboard.upriver.ai 申请访问权限，或发送邮件至 [email protected]。账户启用后，同一个 Upriver 登录账号（或 API 密钥）即可用于所有 MCP 客户端。

链接

• 文档 — https://docs.upriver.ai
• 控制面板 — https://dashboard.upriver.ai
• 网站 — https://upriver.ai

许可证

本代码库的内容——连接文档和列表元数据——依据 MIT License 发布。

托管的 Upriver MCP 服务和 Upriver API 由 Potato Laboratories, Inc. 以 d/b/a Upriver 的名义运营，并受 Upriver 的服务条款约束。MIT License 仅适用于本代码库，不适用于该服务或其返回的数据。“Upriver”和 Upriver 徽标是 Potato Laboratories, Inc. 的商标，不受 MIT License 涵盖。