Skip to main content
Glama
noyacg-mcp

noyacg-mcp

by kwkare

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
NOY_BROWSERNoBrowser channel to use for browser login: chrome, msedge, or chromium. Auto-detected by default.
NOY_SESSIONNoSite cookie value. Can also paste the full NOY_SESSION=xxx string. Highest priority for authentication.
NOY_BASE_URLNoBase URL for pointing the server at a self-hosted or test environment. Defaults to the official domain.
NOY_READONLYNoWhen true, only read-only tools are registered and write operations are removed from the tool list.false
NOY_AUDIT_LOGNoPath to the audit log for write operations. Set to off to disable auditing.~/.noyacg-mcp/audit.jsonl
NOY_BUCKET_URLNoBucket URL for pointing the server at a self-hosted or test environment. Defaults to the official domain.
NOY_TIMEOUT_MSNoTimeout in milliseconds for normal requests.30000
NOY_ALLOW_ADULTNoDefault content-rating setting. Can be overridden per call with the adult tool parameter.false
NOY_SESSION_FILENoPath to the local session file used for authentication.~/.noyacg-mcp/session.json
NOY_MAX_UPLOAD_MBNoMaximum size in megabytes for a single uploaded image.20
NOY_BROWSER_PROFILENoIndependent browser profile directory used for browser login.~/.noyacg-mcp/browser
NOY_BROWSER_HEADLESSNoWhether to run the browser in headless mode, e.g. for servers or CI.false
NOY_UPLOAD_TIMEOUT_MSNoTimeout in milliseconds for image host uploads.120000
NOY_ALLOW_PASSWORD_LOGINNoWhen true, registers the noy_login password-based login tool. Disabled by default for security.false
NOY_DISABLE_BROWSER_LOGINNoWhen 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

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
noy_whoamiA

读取当前 NOY_SESSION 的账号资料:昵称、UID、积分、注册时间、头像,以及全部徽章 + 佩戴中的徽章。这也是最轻的会话探活方式(无副作用),怀疑 cookie 失效时先调它。

noy_home_feedA

读取首页聚合数据:公告、四个书籍榜单(日收藏 / 日阅读 / 推荐位 / 编辑推荐)和番剧推荐(stream)。注意:allow-adult=false 与 true 是两套互斥内容池,标签也会变;stream 只有带 v=3 才返回,本项目已默认带上。

noy_list_postsA

按最新或最热翻社区帖子列表(每页约 40 条)。第 1 页会多带一条置顶帖;len 是近似总数会浮动,判断是否到底请用 over。列表里没有评论内容,要看评论用 noy_read_post。

noy_read_postA

读取一个帖子的完整内容(正文、图片、模糊标记、点赞/回复数)和第一页评论(含楼中楼预览)。评论里 reply_id=-1 是顶层评论;要看完整楼中楼用 noy_read_comment_replies。正文里的 [noygirl:yeah] 是表情包代码、NID123 是书籍引用,都是纯文本存储、前端渲染。

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)重置;今天没签时 continuous 返回 -1(不是 0)。只读;要真的签到用 noy_checkin。

noy_book_detailA

读取一部漫画的完整资料:书名、作者、标签、简介、评分、收藏、章节列表(按分类)、售价、同类推荐,以及首屏评论和评论总数。 章节列表已经内联在详情里,不需要单独请求;想看更多评论用 noy_book_comments。 注意:这是 GET 接口(社区那套是 POST),并且未登录会返回 status: login。

noy_book_commentsA

分页读取一部漫画下的评论(结构与帖子评论一致,但主键字段叫 cid 而不是 rid)。评论里的 [noygirl:yeah] 是表情包代码;楼中楼回复在 replies 里。用 over 判断是否到底。

noy_list_badgesA

列出账号可用的全部徽章和佩戴状态(真实徽章 ID 在这里,userinfo 里的 Id 恒为 0)。要改佩戴状态用 noy_set_badge,不要直接调接口(它不校验 ID,会写脏值)。

noy_upload_imagesA

把本地图片传到 noymanga 的图床,返回发帖可用的 image/<file> 引用。图片一律被服务端转成 webp。这一步本身是写操作(占用图床空间),但不会在社区产生内容。发帖时再引用返回的 file 即可,无需重复上传。

noy_create_postA

在社区发一条帖子,可选带图。⚠️ 不可撤销:站点没有删帖接口,帖子 90 天后自动过期,但期间无法删除;⚠️ 图片是否打码由服务端判定(spoiler),客户端无法指定;发帖不返回帖子 ID,本工具会去列表里回查。正文支持表情包代码(如 [noygirl:yeah])与 NID<书籍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

清除本地保存的登录态(~/.noyacg-mcp/session.json)并让当前进程立即失效,之后所有工具会要求重新登录。 默认只清本地:服务端的会话仍然有效(其它设备不受影响,同一个 cookie 复制走还能用)。 revoke=true 会额外调用 /api/logout 吊销服务端会话——这是不可逆的,之后必须重新登录。 注意:如果登录态来自环境变量 NOY_SESSION,本工具清不掉它,需要用户自己改 MCP 配置。

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

NameDescription
noy_digest翻一遍社区最新 / 热门帖,挑几条值得看的读正文和评论,输出一份摘要
noy_reply_draft读某个帖子(和已有评论),按指定语气起草一条得体的回复,可选带表情包代码

Resources

Contextual data attached and managed by the client

NameDescription
profile当前 NOY_SESSION 的昵称 / UID / 积分 / 徽章 / 佩戴状态(脱敏,不含邮箱明文)
home-feed公告、四个书籍榜单、番剧推荐与标签;allow-adult=false
home-feed-adult同上,但 allow-adult=true。与全年龄是**互斥**的两套内容池
community-latest社区第一页(含置顶帖),字段与 noy_list_posts 相同
inbox-unread讯息中心三个 tab 的未读数(轮询成本很低)
stickers4 组 57 个表情包的代码与图片地址(前端硬编码,无 API)。正文里写 [组:代码] 即可渲染;大小写错误会导致代码**静默消失**,务必用小写。

TDQS

A3.9/5.0

Scored across 20 tools

Disambiguation4/5

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.

Naming Consistency3/5

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.

Tool Count4/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues