Nekoweb

• 不要将它们提交到代码库。 如果 MCP 配置文件位于项目中（例如 .vscode/mcp.json），请使用客户端的密钥输入提示，例如上方 VS Code 按钮所提供的方式，而不要将密钥直接粘贴到文件中。
• 如果密钥泄露，请重新生成。 在 https://nekoweb.org/api 生成新密钥后，旧密钥便会失效。如果会话令牌泄露，请退出 nekoweb.org 以结束该会话。
• 限制本地上传范围。 将 NEKOWEB_LOCAL_ROOT 设置为网站项目文件夹，这样助手就只能从该文件夹上传文件。请参阅配置。

claude mcp add nekoweb -e NEKOWEB_API_KEY=your-api-key -- npx -y nekoweb-mcp-server

打开 Settings → Developer → Edit Config，将服务添加到 claude_desktop_config.json，然后重启 Claude Desktop：

{
  "mcpServers": {
    "nekoweb": {
      "command": "npx",
      "args": ["-y", "nekoweb-mcp-server"],
      "env": {
        "NEKOWEB_API_KEY": "your-api-key",
        "NEKOWEB_SESSION_TOKEN": "your-session-token"
      }
    }
  }
}

若仅使用 API 密钥，请删除 NEKOWEB_SESSION_TOKEN 行（以及它前面的逗号）。

• nekoweb_get_site_info - 获取网站的标题、域名、浏览量、关注者、更新次数和日期（只读）

  • site：其他公开网站的域名，例如 yoursite.nekoweb.org。若要查询你自己的网站，则省略（字符串，可选）
  • response_format：markdown（默认）或 json（字符串，可选）

• nekoweb_list_sites - 列出你账户中的所有网站及其统计数据和存放文件的文件夹（只读）

  • response_format：markdown（默认）或 json（字符串，可选）

• nekoweb_get_limits - 显示你剩余的 API 请求次数以及各项限制的重置时间（只读）

  • response_format：markdown（默认）或 json（字符串，可选）

• nekoweb_list_folder - 列出文件夹中的文件和子文件夹（只读）

  • path：要列出的文件夹，例如 /mysite.nekoweb.org/blog。默认为 /（字符串，可选）
  • recursive：同时列出子文件夹。每个子文件夹会使用一次 API 请求，每次调用最多 25 次（布尔值，可选）
  • max_depth：要列出的子文件夹层级数，1–10，默认为 3（数字，可选）
  • limit：返回的条目数上限，1–500，默认为 100（数字，可选）
  • offset：跳过的条目数，用于翻阅较大的文件夹（数字，可选）
  • response_format：markdown（默认）或 json（字符串，可选）

• nekoweb_read_file - 按原样读取文件源内容，包括 SSI 指令。图片文件（不超过 5 MB）会以图片形式显示（只读）

  • path：要读取的文件，例如 /mysite.nekoweb.org/index.html（字符串，必需）
  • offset：长文件的读取起始字符位置（数字，可选）
  • max_chars：返回的最大字符数，默认为 20,000（数字，可选）

• nekoweb_write_file - 创建文本文件或替换文件的全部内容

  • path：要写入的文件路径，例如 /mysite.nekoweb.org/index.html（字符串，必需）
  • content：文件的完整新内容（字符串，必需）
  • mode：create_or_overwrite（默认）无论文件是否存在都会写入；edit_existing 在文件不存在时会失败（字符串，可选）

• nekoweb_create - 创建空文件或新文件夹

  • path：要创建的路径，例如 /mysite.nekoweb.org/blog（字符串，必需）
  • is_folder：文件夹设为 true，空文件设为 false（布尔值，必需）

• nekoweb_upload_file - 将任意类型的文件上传到文件夹，并替换同名文件。超过 95 MB 的文件会自动分块上传

  • folder：目标文件夹，例如 /mysite.nekoweb.org/images。该文件夹必须已存在（字符串，可选）
  • local_paths：电脑上文件的完整路径（字符串数组，可选）
  • files：以 base64 提供的文件，每个文件包含 name 和 content_base64（对象数组，可选）

• nekoweb_import_zip - 上传 .zip 并将其解压到文件夹中，替换路径相同的文件

  • folder：要解压到的文件夹，例如 /mysite.nekoweb.org（字符串，可选）
  • zip_local_path：电脑上 .zip 文件的完整路径（字符串，可选）
  • zip_base64：以 base64 编码的 .zip，如果未使用 zip_local_path（字符串，可选）

• nekoweb_get_site_settings - 显示网站提供服务的文件夹及其选项：主站、友好链接、严格斜杠、是否列入 Explore、全局动态中的帖子、HTTP 访问和 NSFW（只读）

  • site：你拥有的网站域名，例如 mysite.nekoweb.org。省略时使用 API 密钥所属的网站（字符串，可选）
  • response_format：markdown（默认）或 json（字符串，可选）

• nekoweb_update_site_settings - 更改网站的部分设置；未指定的设置保持不变。关闭友好链接或更改文件夹可能会导致网站链接失效

  • site：你拥有的网站域名。省略时使用 API 密钥所属的网站（字符串，可选）
  • main、nice_links、strict_slash、visible、show_in_global_feed、support_http、nsfw：开启或关闭某个选项（布尔值，可选）
  • folder：网站提供文件服务的文件夹，例如 /mysite.nekoweb.org。该文件夹必须存在（字符串，可选）

• nekoweb_get_tags - 列出你拥有的网站上的标签，以及已使用的标签数和允许使用的标签数（只读）

  • site：你拥有的网站域名，例如 mysite.nekoweb.org。省略时使用 API 密钥所属的网站（字符串，可选）
  • response_format：markdown（默认）或 json（字符串，可选）

• nekoweb_add_tag - 为你拥有的网站添加标签。网站最多可有 10 个标签

  • site：你拥有的网站域名。省略时使用 API 密钥所属的网站（字符串，可选）
  • tag：标签，长度为 2 到 32 个字符，例如 pixel-art（字符串，必填）

• nekoweb_remove_tag - 从你拥有的网站移除标签

  • site：你拥有的网站域名。省略时使用 API 密钥所属的网站（字符串，可选）
  • tag：要移除的标签（字符串，必填）

• nekoweb_get_stats_history - 获取网站浏览量、关注者和更新次数的逐日历史记录，类似于统计页面上的图表（只读）

  • site：你拥有的网站域名。省略时使用 API 密钥所属的网站（字符串，可选）
  • period：month（默认）、year 或 all。Nekoweb 仅在付费套餐中显示 year 和 all（字符串，可选）
  • response_format：markdown（默认）或 json（字符串，可选）

• nekoweb_list_followers - 列出关注你网站的网站，并显示各网站的标题、链接、截图以及你是否也关注了对方（只读）

  • site：你拥有的网站域名。省略时使用 API 密钥所属的网站（字符串，可选）
  • sort：follow_date（默认）、recently_updated 或 most_followed（字符串，可选）
  • page：仅获取此页。省略时获取所有页面，最多 20 页（数字，可选）
  • response_format：markdown（默认）或 json（字符串，可选）

• nekoweb_search_sites - 按名称或标签搜索 Nekoweb「探索」页面上的站点。提供会话令牌后，结果还会显示你关注了哪些站点（只读）

  • query：要搜索的文本。按名称搜索时会匹配域名的一部分；按标签搜索时必须使用确切的标签。省略则浏览所有站点（字符串，可选）
  • by：name（默认）或 tag（字符串，可选）
  • sort：most_viewed（默认）、most_followed、least_viewed、recently_updated、newest 或 oldest（字符串，可选）
  • page：结果页码，每页约 50 个站点，默认为 1（数字，可选）
  • response_format：markdown（默认）或 json（字符串，可选）

• nekoweb_get_news - 获取 nekoweb.org 新闻页面上的最新公告，按时间从新到旧排列（只读）

  • limit：返回的帖子数量，范围为 1 到 100，默认为 5（数字，可选）
  • response_format：markdown（默认）或 json（字符串，可选）

• nekoweb_get_global_feed - 从全局 RSS 动态中获取所有 Nekoweb 站点的最新帖子（只读）

  • limit：返回的帖子数量，范围为 1 到 50，默认为 20（数字，可选）
  • response_format：markdown（默认）或 json（字符串，可选）

• nekoweb_get_feed - 获取你关注的站点的最新帖子，即你的动态中显示的内容（只读，需要会话令牌）

  • page：动态页码，按时间从新到旧排列，默认为 1（数字，可选）
  • response_format：markdown（默认）或 json（字符串，可选）

• nekoweb_list_following - 列出你关注的站点，并按上次更新时间分组。Nekoweb 会排除站点所有者设置为不在「探索」中显示的站点（只读，需要会话令牌）

  • page：仅获取此页。省略则获取所有页面，最多 20 页（数字，可选）
  • response_format：markdown（默认）或 json（字符串，可选）

• nekoweb_follow_site - 关注或取消关注站点。操作前会先检查，因此仅在需要时才会更改状态（需要会话令牌）

  • site：站点的域名，例如 fairfruit.nekoweb.org（字符串，必填）
  • follow：true 表示关注（默认），false 表示取消关注（布尔值，可选）