米游社 MCP Server

基于 MCP 协议的米游社 API 封装，支持搜索帖子、读取评论、发表评论等操作。

快速开始

1. 安装

pip install -e miyoushe-mcp

2. 获取 Cookie（认证）

需要从浏览器中提取 4 个 Cookie 字段。以下以 Chrome/Edge 为例。

方法一：Application 面板（推荐）

Step 1 — 浏览器打开 米游社，确保已登录。

Step 2 — 按 F12 打开开发者工具，点击顶部 Application（应用程序）标签。

Step 3 — 左侧导航找到 Cookies → 点击 bbs.miyoushe.com。右侧会列出所有 Cookie。

Step 4 — 在列表中找到并双击值列，复制以下 4 个字段的 Value：

| Name 列（找这个） | 对应环境变量 | 值的特征 | |-------------------|-------------|---------| | cookie_token | MIYOUSHE_COOKIE_TOKEN | 一长串字母数字 | | ltoken | MIYOUSHE_LTOKEN | 一长串字母数字 | | ltuid | MIYOUSHE_LTUID | 纯数字 | | account_id | MIYOUSHE_ACCOUNT_ID | 纯数字（通常与 ltuid 相同） |

如果没有 account_id，可以直接用 ltuid 的值替代。

方法二：Console 快捷提取

Step 1 — 在已登录的米游社页面按 F12，切换到 Console（控制台）标签。

Step 2 — 输入 允许粘贴 并回车（Chrome 的安全确认）。

Step 3 — 粘贴以下命令并回车：

document.cookie.split('; ').filter(c => c.startsWith('cookie_token') || c.startsWith('ltoken') || c.startsWith('ltuid') || c.startsWith('account_id')).join('\n')

Step 4 — 输出 4 行 key=value，等号后面的就是需要的值。

Cookie 有效期

Cookie 通常有效 7-30 天。过期后认证会失效，届时 MCP 工具会返回错误，只需重新按上述步骤获取新值，替换 .mcp.json 中的对应字段后重启即可。

3. 配置

在项目根目录 .mcp.json 中配置（需替换 command 路径为本机 Python 解释器的绝对路径，Windows 如 C:/xxx/.venv/Scripts/python.exe，Unix 如 /home/xxx/.venv/bin/python）：

{
  "mcpServers": {
    "miyoushe": {
      "command": ".venv/Scripts/python.exe",
      "args": ["-m", "miyoushe_mcp.server"],
      "env": {
        "MIYOUSHE_COOKIE_TOKEN": "你的cookie_token",
        "MIYOUSHE_LTOKEN": "你的ltoken",
        "MIYOUSHE_LTUID": "你的ltuid",
        "MIYOUSHE_ACCOUNT_ID": "你的account_id"
      }
    }
  }
}

4. 重启 Claude Code 即可使用

工具列表

搜索与发现

| 工具 | 说明 | |------|------| | search_posts | 全站搜索帖子，支持按游戏、时间范围过滤和分页 | | get_forum_posts | 获取指定游戏板块帖子列表 | | list_games | 列出支持的游戏及其标识符 |

帖子与评论

| 工具 | 说明 | |------|------| | get_post_detail | 获取帖子完整内容及互动数据（认证后含点赞/收藏状态） | | get_post_replies | 获取帖子评论列表，含嵌套子回复、点赞数、IP 属地 | | get_dynamic_data | 批量获取多个帖子的点赞/评论/收藏/转发数 |

用户

| 工具 | 说明 | |------|------| | get_user_info | 获取用户资料（昵称/头像/简介/等级/认证） | | get_user_posts | 获取用户发帖列表 | | download_images | 下载帖子图片到本地 |

资讯

| 工具 | 说明 | |------|------| | get_news_list | 获取官方公告/活动/资讯 |

写操作（需认证）

| 工具 | 说明 | |------|------| | create_comment | 在帖子下发表评论 | | login | 验证 Cookie 有效性 |

支持的游戏

| 游戏 | 标识符 | |------|--------| | 原神 | genshin | | 崩坏：星穹铁道 | starrail | | 绝区零 | zzz | | 崩坏3 | honkai3rd | | 未定事件簿 | tears |

项目结构

miyoushe-mcp/
  src/miyoushe_mcp/
    server.py    # MCP 工具注册
    client.py    # HTTP 客户端（DS 签名、认证注入）
    auth.py      # 密码登录认证模块
    config.py    # 常量配置（salt、版本号、RSA 公钥）
    models.py    # Pydantic 数据模型

.claude/skills/miyoushe-intel/
  SKILL.md      # 米游社情报速查 Skill

authentication.md   # DS 签名算法参考文档
password_hoyolab.md # 密码登录 API 参考文档
article.md          # 帖子相关 API 参考文档
info.md             # 用户相关 API 参考文档