NudgeHost

NudgeHost MCP 服务

NudgeHost 是一项面向用户和 AI Agent 的文件托管服务。上传任意文件，几秒钟内即可获得链接。无需账户。

本仓库介绍 NudgeHost 的远程 MCP 服务，并收录其注册表条目。该服务运行于 https://www.nudgehost.com/api/mcp，因此无需在此安装或运行任何内容。完整文档请参阅 nudgehost.com/docs/api。

注册表条目

该服务已列入官方 MCP Registry，名称为 com.nudgehost/file-hosting。本仓库中的 server.json 就是该条目。

你需要 API 密钥

网站允许无需账户即可上传文件。MCP 服务则有所不同，因为它的工具会对账户进行操作，因此每个请求都需要携带 API 密钥。免费账户就足够使用。所有套餐都可以使用 API，包括免费套餐；免费账户最多可同时持有 2 个密钥。

1. 在 nudgehost.com 注册。
2. 打开控制面板中的 API 密钥面板并创建密钥。密钥只会显示一次，因此关闭面板前请先复制。
3. 将环境变量 NUDGEHOST_API_KEY 设置为该密钥，然后启动或重启客户端。

所有请求都应发送到 www.nudgehost.com。根域名 nudgehost.com 会重定向到 www，重定向时会丢弃 Authorization 标头，因此即使密钥有效，也会返回 401。以下配置均已使用 www。

四个工具

工具	功能
share_text	一次调用即可将文本发布为文件并返回链接。文件名以 .html 或 .htm 结尾时，收件人可在浏览器中阅读该页面。.csv 或 .json 文件会在表格或 JSON 查看器中打开。.md 或 .markdown 文件会显示为格式化文本，并提供 Source 视图和 Copy source 按钮；其中的 HTML 会按原样显示。其他文件名则会将文本显示为纯文本，并提供 Copy text 按钮。每个粘贴内容都可通过链接后加 /raw 获取原始文本。内容上限为 2MB，按 UTF-8 字节数计算。
create_upload_url	为服务端尚未持有的文件启动上传，并返回用于发送文件字节的 URL。该 URL 会在 300 秒后过期。
complete_upload	文件字节发送完毕后完成上传。重复调用也不会有问题。包含索引文件的 ZIP 会在其专属地址成为托管网站。
list_links	按时间从新到旧列出账户的链接。limit 接受 1 到 100 之间的整数，默认值为 50；cursor 用于获取下一页。

连接客户端

以下配置摘自文档页面中的连接客户端。

以下每种配置都使用环境变量 NUDGEHOST_API_KEY，而非密钥本身，这样密钥就不会出现在配置文件中。将该变量设置为控制面板中的 API 密钥，然后启动或重启客户端，使其读取新值。

Claude Code。 将以下内容放入启动 Claude Code 的文件夹中的 .mcp.json。测试日期为 2026 年 10 月 13 日，使用默认运行时，并将 MCP_PROTOCOL_NEGOTIATION 设置为 legacy。

{
  "mcpServers": {
    "nudgehost": {
      "type": "http",
      "url": "https://www.nudgehost.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${NUDGEHOST_API_KEY}"
      }
    }
  }
}

Cursor。 将以下条目添加到 ~/.cursor/mcp.json，Cursor 会为每个项目读取该文件。测试日期为 2026 年 10 月 13 日。

{
  "mcpServers": {
    "nudgehost": {
      "url": "https://www.nudgehost.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NUDGEHOST_API_KEY}"
      }
    }
  }
}

Codex CLI。 将以下表格添加到 ~/.codex/config.toml。无需启用功能标志。测试日期为 2026 年 10 月 13 日。

[mcp_servers.nudgehost]
url = "https://www.nudgehost.com/api/mcp"
bearer_token_env_var = "NUDGEHOST_API_KEY"

Codex CLI 测试涵盖了连接和列出链接。

示例

在 Cursor 中将 ZIP 发布为网站将介绍如何通过三个步骤将文件夹转换为在线网站。

速率限制

每个密钥在每个 60 秒窗口内可发送固定数量的请求，具体取决于账户套餐。

• Free：每 60 秒 20 个请求
• Pro：每 60 秒 60 个请求
• Studio：每 60 秒 150 个请求

MCP 工具和 REST API 共用每个密钥的请求额度。上传大小和在线链接数量也取决于套餐，当前数值请参阅定价页面。

许可证

本仓库中的文本和示例遵循 MIT 许可证。NudgeHost 服务有自己的条款。