jiuyan-mcp

韭研公社（jiuyangongshe.com）数据获取 MCP 服务器。

优先免登录获取公开特色数据（时间轴、热榜、搜索、文章全文、社区栏目）；「异动」与「关注流」为站内登录数据，配置网页 SESSION cookie 后可用。

仅供个人学习与研究，请尊重站点服务条款，勿高频抓取或商用。本仓库与韭研公社官方无任何关联。

工具一览

Related MCP server: A-Stock MCP Server

快速开始

git clone <repo-url> && cd jiuyan-mcp
npm install

在你的 MCP 客户端配置（如 ~/.omp/agent/mcp.json）中注册：

{
  "mcpServers": {
    "jiuyan": {
      "type": "stdio",
      "command": "node",
      "args": ["/绝对路径/jiuyan-mcp/src/index.js"],
      "env": {
        "JIYAN_SESSION": "<可选：网页 SESSION cookie 值>"
      }
    }
  }
}

登录 cookie（JIYAN_SESSION）获取

1. 浏览器登录 www.jiuyangongshe.com；

2. F12 → Application/存储 → Cookies → https://www.jiuyangongshe.com；

3. 复制名为 SESSION 的值填入 JIYAN_SESSION；

4. 重启 MCP 客户端。未配置时匿名工具照常工作，登录工具返回明确提示。

签名机制（为什么需要这个服务器才能跑）

韭研公社 web API（web-api.jiuyangongshe.com/jystock-app）每个请求要求 token + timestamp 头。签名原料由 SSR 页面内嵌（window.__NUXT__ 中混淆键的 {digest, project, serverTime}）， 推导算法藏在 Nuxt 打包的 VM 混淆模块里。本项目在 node:vm 沙箱内收割 webpack 模块表并 require 该模块，从它的导出（或它挂到 globalThis 的函数）里按「调用形状」找出签名函数， 直接调用生成每次请求的头，全程无需浏览器。

健壮性设计：

• digest 键名、模块 id、函数名均为混淆产物——digest 用宽松正则提取，模块先试已知 id、 再按「向 globalThis 批量挂导出」特征扫描兜底，函数按输出形状自动发现（token 只校验 「hex 且 ≥32 位」，实测站点已从 32 位变 64 位），站点发版轮换名字也能自适应；

• 沙箱的 window 与全局对象是同一个对象并补齐 navigator/document 桩——站点前沿代码 会读 navigator.platform、document，缺桩会导致签名模块初始化静默失败；

• 服务端按时间窗校验 timestamp（实测偏移 1 小时即 errCode=110），签名时间以页面 serverTime 校正本机时钟偏移；

• token 失效（errCode=110）时自动重抓页面重建沙箱并重试一次；HTTP 5xx/连接层错误重试一次；

• chunk 文件缓存于系统临时目录（7 天），避免重复下载 ~2MB 静态资源；

• 相邻上游请求强制 ≥1s 间隔，礼貌限速。

已知限制

• 「异动」全家桶与关注流必须登录态（errCode=1），匿名无法绕过；

• 登录态以 SESSION cookie 承载（web 端 axios withCredentials），失效后需重新复制；

• /api/v1/action/detail 等 APP 专用端点被版本门禁拦截（errCode=9），web 端不可用；

• 部分端点对参数存在“必填但取值被忽略”的要求（如 search 的 back_garden、 action/list 的 start/limit），缺失直接报 12003——工具已按实测补齐默认值；

• 站点前端大版本升级可能导致签名模块 id 变化；已知 id 失效时会走特征扫描兜底， 扫描也失败才需更新 KNOWN_MODULE_IDS。

结构

src/
  signer.js   # SSR digest 抓取 + vm 沙箱签名函数发现与调用
  api.js      # HTTP 客户端：鉴权头、限速、errCode 映射、110/5xx 自动重试
  tools.js    # 8 个 MCP 工具定义与入参 schema
  index.js    # stdio MCP 服务器入口

License

MIT