replynodes

@replynodes/mcp

ReplyNodes MCP

通过一个远程 MCP 端点，将 AI Agent 连接到 ReplyNodes 的公开上下文工具。可用于：

• 网页 → Markdown 提取、网页搜索、同源爬取和 URL 映射
• 品牌情报，包括公开品牌资料、搜索、风格指南和字体
• Reddit、YouTube、App Store、Google Play 和 Hacker News 研究

标准远程端点为：

https://mcp.replynodes.com/mcp

实时 tools/list 响应是权威信息。目前其中包含研究工具和经过身份验证的监控工具；请勿根据本 README 推断完整的工具范围。如果客户端支持直接连接远程 MCP，请使用该端点和客户端原生的身份验证流程，而不要安装此软件包。

身份验证

交互式远程客户端使用原生 Better Auth MCP OAuth。连接到 https://mcp.replynodes.com/mcp；OAuth 颁发方为 https://auth.replynodes.com，所需范围为 mcp:read。

无头和手动客户端使用带有 rn_test_* 或 rn_live_* 前缀的 ReplyNodes API 密钥。组织权限根据经过身份验证的身份或密钥解析；客户端无需发送组织 ID。

此软件包中的 stdio 桥接使用 API 密钥：它会在启动时读取 REPLYNODES_API_KEY，并将其作为 Authorization 标头发送。它不会执行浏览器 OAuth、打印密钥或持久化密钥。

设置

Claude Desktop、Claude Code、Cursor 或 Windsurf — 原生远程 MCP

在每个客户端的远程 MCP 配置中使用标准 URL：

https://mcp.replynodes.com/mcp

出现提示时，使用颁发方 https://auth.replynodes.com 和范围 mcp:read 完成原生 Better Auth MCP OAuth。请勿添加组织 ID。有关确切的 UI 或配置格式，请参阅标准 MCP 端点以及客户端的 MCP 配置帮助。

Claude Desktop、Claude Code、Cursor 或 Windsurf — stdio/API 密钥

将以下内容添加到客户端的 MCP 配置中：

{
  "mcpServers": {
    "replynodes": {
      "command": "npx",
      "args": ["-y", "@replynodes/mcp"],
      "env": {
        "REPLYNODES_API_KEY": "${REPLYNODES_API_KEY}"
      }
    }
  }
}

Codex CLI、OpenClaw 或其他无头/手动客户端

对于支持原生远程 MCP 和交互式登录的客户端，请使用上述标准 URL 和 OAuth 信息。对于无人值守或 stdio 使用场景，请通过客户端的密钥/环境变量支持配置 rn_test_* 或 rn_live_* 密钥：

在客户端的 MCP 设置中配置相同的命令，或运行：

REPLYNODES_API_KEY="${REPLYNODES_API_KEY:?Set REPLYNODES_API_KEY}" npx -y @replynodes/mcp

示例使用由环境变量提供的 REPLYNODES_API_KEY 占位符。请勿将真实密钥放入 shell 历史记录、源文件、命令行参数或已提交的配置中。

工具行为

远程服务通过 MCP tools/list 暴露 ReplyNodes 的实时工具范围。大多数发现和公开数据工具以读取为主，而当前端点还包含经过身份验证的监控操作，例如 monitor_create 和 monitor_update。工具名称和架构可能会变化；连接后请使用 tools/list 发现工具。

此 npm 软件包是传输桥接，不会添加工具或向社交渠道发布内容。请勿将不受信任端点返回的工具名称或描述视为执行操作的许可。

环境变量

变量	必需	描述
REPLYNODES_API_KEY	是	用于无头／手动使用的 rn_test_* 或 rn_live_* API 密钥。仅从环境变量读取。
REPLYNODES_MCP_URL	否	受信任的 HTTPS 端点覆盖值。默认为 https://mcp.replynodes.com/mcp。

端点覆盖值适用于兼容的 HTTPS 部署或测试。 如果覆盖值不是有效的 HTTPS URL，则会被拒绝。切勿在覆盖 URL 中包含凭据。 默认端点是受支持的公共只读服务。

其他命令行参数会转发给 mcp-remote（例如 --debug）。调试日志可能会暴露连接详情，因此仅在需要时使用，且切勿分享包含凭据的日志。

原生远程 MCP（无需安装）

支持原生远程 MCP 的客户端可以直接连接到：

URL: https://mcp.replynodes.com/mcp

使用原生 Better Auth MCP OAuth，签发者为 https://auth.replynodes.com，范围为 mcp:read。请勿在 URL 和命令行参数中包含凭据。对于无头／手动客户端，请改为将 rn_test_* 或 rn_live_* API 密钥作为 Bearer 凭据发送。

实时工具范围

连接后，使用 tools/list 发现当前工具。已验证的功能类别包括：

• web — 搜索、提取干净的 Markdown、同源爬取、URL 映射和品牌提取
• brand — 公开品牌搜索、检索、风格指南和字体
• Reddit — 公开帖子、subreddit 和用户研究
• YouTube — 搜索、视频、频道、评论、播放列表、相关内容和转录研究
• App Store — 公开应用、开发者、评论、评分、隐私、相似应用和搜索数据
• Google Play — 公开应用、类别、开发者、评论、权限、安全性、可用性、相似应用和搜索数据
• Hacker News — 公开故事、条目、搜索和用户研究
• monitor — 经过身份验证的监控项列表、创建、检查、更新、变更和运行

确切的工具集和架构以运行时为准。请勿宣传未通过 https://mcp.replynodes.com/mcp 上实时 tools/list 返回的工具或功能。

Cursor 和其他 IDE 生态系统

ReplyNodes 通过两种方式提供给 Cursor：原生远程 MCP 服务，以及捆绑了相同远程 MCP 服务的 Cursor 插件。

无头／手动远程 MCP（API 密钥）

对于无头／手动 Cursor 使用场景，请在 mcp.json 中配置远程 MCP 服务，使用规范 URL 和从环境变量读取的 Bearer 密钥。将 ReplyNodes 添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

{
  "mcpServers": {
    "replynodes": {
      "url": "https://mcp.replynodes.com/mcp",
      "headers": {
        "Authorization": "Bearer ${REPLYNODES_API_KEY}"
      }
    }
  }
}

无头／手动使用时，请在环境变量中设置 REPLYNODES_API_KEY。对于交互式 Cursor 会话，请使用原生 Better Auth MCP OAuth，签发者为 https://auth.replynodes.com，范围为 mcp:read。请参阅 Cursor 的 MCP 文档： https://cursor.com/docs/mcp，以及手动安装帮助： https://cursor.com/help/customization/mcp。

Cursor 插件（一键安装 + deeplink + 支持上架市场）

本仓库的 .cursor-plugin/ 中包含一个封装相同远程 MCP 服务的 Cursor 插件：

• 插件清单：https://github.com/replynodes/replynodes-mcp/blob/master/.cursor-plugin/plugin.json
• 徽标：https://github.com/replynodes/replynodes-mcp/blob/master/assets/logo.svg

该插件使用规范的生产端点 https://mcp.replynodes.com/mcp， 并通过 Bearer REPLYNODES_API_KEY 请求头进行身份验证。密钥声明为插件变量，因此 Cursor 会在插件配置界面中提示输入。

使用 Cursor deeplink 安装

Cursor 支持以下形式的 MCP 安装 deeplink：

cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64_ENCODED_CONFIG

ReplyNodes 的 deeplink（远程 HTTP MCP，Bearer API 密钥）如下：

cursor://anysphere.cursor-deeplink/mcp/install?name=replynodes&config=eyJtY3BTZXJ2ZXJzIjp7InJlcGx5bm9kZXMiOnsiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7UkVQTFlOT0RFU19BUElfS0VZfSJ9LCJ1cmwiOiJodHRwczovL21jcC5yZXBseW5vZGVzLmNvbS9tY3AifX19

请根据 Cursor 文档 https://cursor.com/docs/mcp/install-links 重新生成并测试你自己的 deeplink。

提交到 Cursor Marketplace

该插件已准备好提交。要将其列入公开的 Cursor Marketplace：

1. 确认该插件位于 https://github.com/replynodes/replynodes-mcp 的公开 Git 分支上。
2. 登录 https://cursor.com/marketplace/publish。
3. 提交仓库 URL。

提交清单（来自 https://cursor.com/docs/reference/plugins）：有效的 .cursor-plugin/plugin.json 清单；唯一的小写 kebab-case 名称；清晰的 描述；有效的组件文件；已提交并通过相对路径引用的徽标；包含用法和配置的 README；清单 variables 架构中声明的所有 ${VAR}；有效的相对路径；已在本地测试。所有 Marketplace 插件都必须开源，并在列出前经过人工审核 （https://cursor.com/help/security-and-privacy/marketplace-security）。

分发状态

渠道	状态	URL
官方 MCP Registry	已上线	https://registry.modelcontextprotocol.io/v0.1/servers/com.replynodes%2Fmcp/versions/latest
Smithery	已有条目，但在线元数据已过时（代理端点、auth.md 和查询参数 apiKey）；更新需外部操作／所有者授权	https://smithery.ai/servers/replynodes/mcp
Cursor 插件（位于此仓库中）	已准备好提交	https://github.com/replynodes/replynodes-mcp/tree/master/.cursor-plugin
Cursor 深层链接	已验证的安装路径	cursor://anysphere.cursor-deeplink/mcp/install?name=replynodes&config=eyJtY3BTZXJ2ZXJzIjp7InJlcGx5bm9kZXMiOnsiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7UkVQTFlOT0RFU19BUElfS0VZfSJ9LCJ1cmwiOiJodHRwczovL21jcC5yZXBseW5vZGVzLmNvbS9tY3AifX19
Cursor Marketplace 条目	尚未列出	在 https://cursor.com/marketplace/publish 提交（需所有者操作）
Claude Code 插件（位于此仓库中）	已有，使用 stdio 桥接	https://github.com/replynodes/replynodes-mcp/tree/master/.claude-plugin
Claude Code 社区 Marketplace	提交需所有者授权	https://code.claude.com/docs/en/plugins.md

许可证

MIT