noyacg-mcp

NoyAcg / noymanga.com 的 MCP server —— 让 AI agent 直接看社区、读帖子、查榜单、发帖评论、签到、管徽章。

基于仓库 NoyAcg-API-Collect 里逐条实测过的接口契约实现，TypeScript + stdio，接 Claude Desktop / Cursor / 任何支持 MCP 的宿主。

最省事的用法：配好路径 → 让 agent 弹个浏览器窗口 → 你自己登录 → 完事。不用翻 DevTools 复制 cookie。

你：看看社区今天有什么热闹，挑两条有意思的说给我听
agent → noy_list_posts(sort=like) → noy_read_post(78912) → noy_inbox(kind=count)
agent：今天热帖是……（附带评论里在吵什么）

特性

• 浏览器登录：noy_browser_login 打开独立 Chrome 窗口，用户自己登录，自动抓 NOY_SESSION 并保存，当前进程立刻生效

• 16 个任务级工具：不是一个端点一个工具，而是「看帖」「发评论」「签到」这种完成一件事的工具

• 6 个资源（noy://）：主页资料、首页榜单、最新帖、未读数、表情包代码表，可按需加载 / 缓存

• 2 个提示词模板：社区速览、评论起草

• 写操作直接执行 + 审计日志：每次发帖 / 评论 / 点赞 / 签到 / 徽章变更都追加一行 JSONL

• 把踩过的坑写进工具里：allow-adult 默认 false、点赞幂等、徽章 ID 校验、签到先查再签、表情包大小写检查……

Related MCP server: JMComic AI MCP Server

安装

git clone https://github.com/kwkare/NoyAcg-MCP.git
cd NoyAcg-MCP
npm ci
npm run build

# 登录（会弹出 Chrome，登录一次即可）
node dist/index.js login
node dist/index.js status     # 确认会话有效

要求 Node.js ≥ 18.17，以及 Chrome（或 Edge / npx playwright install chromium）。

配置

登录态有三种给法，优先级：环境变量 > 本地会话文件。

A. 浏览器登录（推荐）

node dist/index.js login          # 打开 Chrome，登录后自动保存并关闭
node dist/index.js login --timeout 120

• 用的是独立 profile（~/.noyacg-mcp/browser），不会动你日常浏览器的登录态；

• 登录过一次之后再打开通常已是登录状态，秒完成；

• Cookie 存到 ~/.noyacg-mcp/session.json，权限 0600；

• 也可以在对话里让 agent 调 noy_browser_login：先 action=open 弹窗，登录好后 action=wait 保存，不用重启 MCP。

会话文件里是明文 Cookie，等同账号凭证。别提交到 git、别随手发给别人。

B. Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "noyacg": {
      "command": "node",
      "args": ["/absolute/path/to/NoyAcg-MCP/dist/index.js"]
    }
  }
}

不需要 env：登录态从 ~/.noyacg-mcp/session.json 读。想用环境变量覆盖，就再加 "env": { "NOY_SESSION": "..." }（见 examples/claude_desktop_config.cookie.json）。

Cursor / 其它

.cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局），结构同上。VS Code、Cline、Continue 等只要是 stdio MCP 客户端都一样。

环境变量

工具

只读

登录

写操作（直接生效，无二次确认）

资源

提示词

• noy_digest：翻社区、挑帖子、读评论，输出速览（可指定关注主题）

• noy_reply_draft：读帖后按指定语气起草评论（默认只起草、不发送）

安全与边界

这个 MCP 会真的操作你的账号。 设计上的护栏：

• Cookie 只存在本地：~/.noyacg-mcp/session.json（0600）与独立浏览器 profile；登录过程不经过第三方，密码直接输在 noymanga 的页面上

• 写操作直接执行（按需求如此），但每次都会写审计日志：ts / tool / args / ok / result，Cookie 与 token 自动打码

• NOY_READONLY=true 可以一键把写工具从工具列表里摘掉，只留只读

• noy_like_post / noy_set_badge 都是「先读当前状态 → 需要才调」，避免重复调用把自己翻转回去

• noy_set_badge 会先校验 ID：官方接口不校验，传垃圾值会永久写进 show 数组

• noy_create_post 会检查正文里的表情包代码：大小写写错会被前端静默吞掉（不是显示成文字），工具会直接警告

• 账号密码登录默认不注册（密码会进对话记录与宿主日志），要开得显式设 NOY_ALLOW_PASSWORD_LOGIN=true

其它事实（都会影响 agent 的判断）：

• 帖子 / 评论 没有删除接口，只能等 90 天过期；过期后从列表消失但链接仍可访问

• 点赞、徽章佩戴都是开关式，重试一次 = 翻转回去

• 签到按 UTC+8 00:00 重置，每次 +1 积分；重复签到返回数字 status=500

• 内容分「全年龄 / R18」两套互斥内容池，allow-adult 不同则榜单、标签全变

• 站内没有「标记已读」接口：打开消息页即已读

开发

npm run build      # tsc
npm test           # 单元 + 集成（内置假站点 + headless Chrome，不碰真实站点）
npm run smoke      # 真正拉起 stdio server 走一遍 JSON-RPC
node dist/index.js status   # 检查真实登录态

测试分四层（36 个用例）：

1. test/client.test.mjs：HTTP 客户端（编码、Cookie、分级头、错误映射、multipart、图片 URL 拼接）

2. test/tools.test.mjs + test/mock-site.mjs：完整 MCP 协议跑全部工具，含发帖 / 评论 / 点赞 / 签到 / 徽章等写流程（对假站点，不会产生真实内容）

3. test/session.test.mjs + test/browser-login.test.mjs：会话文件读写与权限、headless Chrome 上的真实登录流程（抓 cookie → 校验 → 落盘）、MCP 工具端到端；本机没有浏览器时自动 skip

4. scripts/smoke.mjs：未登录状态下的工具清单、资源、提示词、错误提示

接口契约以 NoyAcg-API-Collect 的 docs/ 为准；那边是人工实测记录，这边是它的可执行封装。

许可证

MIT。非官方项目，与 NoyAcg 官方无关；请遵守站点规则，不要用它刷帖 / 刷积分。