noyacg-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NOY_BROWSER | No | Browser channel to use for browser login: chrome, msedge, or chromium. Auto-detected by default. | |
| NOY_SESSION | No | Site cookie value. Can also paste the full NOY_SESSION=xxx string. Highest priority for authentication. | |
| NOY_BASE_URL | No | Base URL for pointing the server at a self-hosted or test environment. Defaults to the official domain. | |
| NOY_READONLY | No | When true, only read-only tools are registered and write operations are removed from the tool list. | false |
| NOY_AUDIT_LOG | No | Path to the audit log for write operations. Set to off to disable auditing. | ~/.noyacg-mcp/audit.jsonl |
| NOY_BUCKET_URL | No | Bucket URL for pointing the server at a self-hosted or test environment. Defaults to the official domain. | |
| NOY_TIMEOUT_MS | No | Timeout in milliseconds for normal requests. | 30000 |
| NOY_ALLOW_ADULT | No | Default content-rating setting. Can be overridden per call with the adult tool parameter. | false |
| NOY_SESSION_FILE | No | Path to the local session file used for authentication. | ~/.noyacg-mcp/session.json |
| NOY_MAX_UPLOAD_MB | No | Maximum size in megabytes for a single uploaded image. | 20 |
| NOY_BROWSER_PROFILE | No | Independent browser profile directory used for browser login. | ~/.noyacg-mcp/browser |
| NOY_BROWSER_HEADLESS | No | Whether to run the browser in headless mode, e.g. for servers or CI. | false |
| NOY_UPLOAD_TIMEOUT_MS | No | Timeout in milliseconds for image host uploads. | 120000 |
| NOY_ALLOW_PASSWORD_LOGIN | No | When true, registers the noy_login password-based login tool. Disabled by default for security. | false |
| NOY_DISABLE_BROWSER_LOGIN | No | When true, does not register the noy_browser_login tool. Useful in environments without a desktop. | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| noy_whoamiA | 读取当前 NOY_SESSION 的账号资料:昵称、UID、积分、注册时间、头像,以及全部徽章 + 佩戴中的徽章。这也是最轻的会话探活方式(无副作用),怀疑 cookie 失效时先调它。 |
| noy_home_feedA | 读取首页聚合数据:公告、四个书籍榜单(日收藏 / 日阅读 / 推荐位 / 编辑推荐)和番剧推荐(stream)。注意:allow-adult=false 与 true 是两套互斥内容池,标签也会变;stream 只有带 v=3 才返回,本项目已默认带上。 |
| noy_list_postsA | 按最新或最热翻社区帖子列表(每页约 40 条)。第 1 页会多带一条置顶帖; |
| noy_read_postA | 读取一个帖子的完整内容(正文、图片、模糊标记、点赞/回复数)和第一页评论(含楼中楼预览)。评论里 |
| noy_read_comment_repliesA | 读取某条评论下的全部回复(楼中楼),按时间倒序。评论详情接口通常已内联前几条,这里用于「加载更多」。root_id 是根评论的 rid,reply_id 指向被回复的那一条。 |
| noy_inboxA | 读取站内讯息。kind=count 只取未读计数(最省,适合轮询);kind=comment 是「书籍评论的回覆」;kind=community 是「我参与过的帖子下的回复流」——它不是严格的「别人回复我」,需要自己按 cid 过滤自己的帖子。站内没有「标记已读」接口:打开消息页即自动已读。 |
| noy_signin_statusA | 查今天是否已签到、连续天数、最近记录。每天 00:00(UTC+8)重置;今天没签时 |
| noy_book_detailA | 读取一部漫画的完整资料:书名、作者、标签、简介、评分、收藏、章节列表(按分类)、售价、同类推荐,以及首屏评论和评论总数。
章节列表已经内联在详情里,不需要单独请求;想看更多评论用 noy_book_comments。
注意:这是 GET 接口(社区那套是 POST),并且未登录会返回 |
| noy_book_commentsA | 分页读取一部漫画下的评论(结构与帖子评论一致,但主键字段叫 cid 而不是 rid)。评论里的 |
| noy_list_badgesA | 列出账号可用的全部徽章和佩戴状态(真实徽章 ID 在这里,userinfo 里的 Id 恒为 0)。要改佩戴状态用 noy_set_badge,不要直接调接口(它不校验 ID,会写脏值)。 |
| noy_upload_imagesA | 把本地图片传到 noymanga 的图床,返回发帖可用的 |
| noy_create_postA | 在社区发一条帖子,可选带图。⚠️ 不可撤销:站点没有删帖接口,帖子 90 天后自动过期,但期间无法删除;⚠️ 图片是否打码由服务端判定(spoiler),客户端无法指定;发帖不返回帖子 ID,本工具会去列表里回查。正文支持表情包代码(如 |
| noy_commentA | 在帖子下发评论。不带 reply_to_rid 是顶层评论(reply_id=-1);带 reply_to_rid 是楼中楼回复。正文支持表情包代码。⚠️ 评论没有删除接口,发了就一直在;接口不返回评论 ID,本工具会回读列表找出新 rid。 |
| noy_edit_postA | 修改自己帖子的标题和/或正文(只传要改的字段,未传的沿用当前值)。只能改文字,改不了图片和 spoiler;编辑不会把帖子顶到前面。⚠️ 会覆盖原内容,请先 noy_read_post 确认。 |
| noy_like_postA | 给帖子点赞或取消点赞。接口是开关式(调一次翻转一次),所以本工具会先读当前状态再决定要不要调,并在调用后回读确认。可以指定 action=like / unlike 表达明确意图,避免重复调用把自己又取消掉。 |
| noy_checkinA | 执行每日签到(+1 积分,连续天数 +1)。会先查记录:今天已签则直接返回、不重复调用。站点按 UTC+8 的 00:00 重置;签到时间不记录具体时刻,统一写当天 0 点。 |
| noy_set_badgeA | 设置徽章佩戴状态。接口本身是开关式且不校验 ID(传垃圾值会写进 show 数组),所以本工具会先校验 ID 是否在徽章表里,再按当前状态决定是否需要切换,保证幂等。 |
| noy_set_profile_imageA | 上传本地图片并设为头像或主页背景图(服务端会把新文件直接写进资料,没有单独的「保存」接口)。 ⚠️ 会覆盖当前头像/背景图,旧文件不会自动删除;工具会返回旧地址,方便你回滚。 头像与背景图走不同的图床端点(upload_avatar / upload_bg),限制比发帖图片更严(过大会报 size)。 |
| noy_logoutA | 清除本地保存的登录态( |
| noy_browser_loginA | 打开一个独立的 Chrome 窗口让用户自己输入账号密码,登录成功后自动读取 NOY_SESSION 并保存到本地,之后所有工具立刻可用(不用重启、不用手动复制 cookie)。 如果这个 profile 之前登录过,会直接复用、不弹窗(约 1 秒完成)——所以可以先无脑调一次 wait 试试。 用法:action=open 只开窗口(马上返回);action=wait 打开并在 timeout_seconds 内等待保存;action=cancel 关掉窗口。等待超时不会关窗口,用户登完再调一次 wait 即可。 ⚠️ 窗口是本项目专用的独立 profile(~/.noyacg-mcp/browser),不会动用户日常浏览器的登录态。 ⚠️ 只在用户明确要求「帮我登录」时调用,不要自作主张弹窗。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| noy_digest | 翻一遍社区最新 / 热门帖,挑几条值得看的读正文和评论,输出一份摘要 |
| noy_reply_draft | 读某个帖子(和已有评论),按指定语气起草一条得体的回复,可选带表情包代码 |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| profile | 当前 NOY_SESSION 的昵称 / UID / 积分 / 徽章 / 佩戴状态(脱敏,不含邮箱明文) |
| home-feed | 公告、四个书籍榜单、番剧推荐与标签;allow-adult=false |
| home-feed-adult | 同上,但 allow-adult=true。与全年龄是**互斥**的两套内容池 |
| community-latest | 社区第一页(含置顶帖),字段与 noy_list_posts 相同 |
| inbox-unread | 讯息中心三个 tab 的未读数(轮询成本很低) |
| stickers | 4 组 57 个表情包的代码与图片地址(前端硬编码,无 API)。正文里写 [组:代码] 即可渲染;大小写错误会导致代码**静默消失**,务必用小写。 |
TDQS
Scored across 20 tools
Most tools target clearly distinct resources or actions: check-in status vs check-in action, post read/create/edit/comment, book detail vs book comments, and session tools are separable. Mild overlap exists between noy_upload_images and noy_set_profile_image, and between noy_inbox comment/community streams and comment-reply readers, but the descriptions mostly disambiguate them.
All tools share the noy_ prefix and snake_case, which keeps the surface readable. However, conventions mix verb_noun forms like read_post and create_post with noun-only forms like inbox, whoami, home_feed, and book_detail, and noy_comment is somewhat ambiguous as either a verb or noun.
20 tools is slightly above the ideal range but justified by the broad surface: auth/session, daily check-in, inbox, community posts/comments, books, badges, and image upload. Each tool maps to a distinct operation, though the set is still on the heavy side.
Core workflows are covered: session management, check-in, inbox checks, post lifecycle, commenting, book browsing, badges, and image upload. Notable gaps include search, richer user/profile operations, and paginated top-level post comment reading, though some absences reflect missing site APIs such as delete.