技术文档摘要

Kakuyomu MCP Server

这是一个MCP（模型上下文协议）服务器，用于加载小说投稿网站「卡克尤姆」的内容。该工具允许LLM代理执行卡克尤姆的作品搜索、获取章节列表、读取正文等功能。

功能

• 作品搜索: 关键词搜索和详细过滤（如类型、评价数量、字数、发布日期等）
• 首页获取: 获取最新作品列表
• 章节列表: 获取特定作品的章节信息
• 正文读取: 获取特定章节的正文内容

🚀 快速试用

在Docker Hub上公开的镜像可以让你快速开始使用。

在Claude Code中使用

# 从dockerhub拉取镜像
docker pull ubiq/kakuyomu-mcp:latest
# 添加到claude code配置中
claude mcp add kakuyomu-mcp -- docker run -i --rm ubiq/kakuyomu-mcp:latest
# 启动
claude

在Claude Desktop中使用

# 从dockerhub拉取镜像
docker pull ubiq/kakuyomu-mcp:latest

在claude_desktop_config.json中添加以下内容，并重启Claude Desktop：

{
  "mcpServers": {
    "kakuyomu_mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ubiq/kakuyomu-mcp:latest"
      ],
      "env": {}
    }
  }
}

安装

所需环境

• Python 3.10及以上版本
• Poetry

设置

# 克隆仓库
git clone https://github.com/106-/kakuyomu-mcp.git
cd kakuyomu-mcp

# 安装依赖
poetry install

使用方法

启动服务器

# 直接运行
make run

使用Docker运行

# 在Docker容器中运行
make docker-run

在Claude Code (MCP) 中使用

在.mcp.json文件中添加以下设置：

{
  "mcpServers": {
    "kakuyomu_mcp": {
      "type": "stdio",
      "command": "poetry",
      "args": [
        "run",
        "python",
        "./kakuyomu_mcp/main.py"
      ],
      "env": {}
    }
  }
}

如果使用Docker：

{
  "mcpServers": {
    "kakuyomu_mcp": {
      "type": "stdio", 
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "kakuyomu-mcp"
      ],
      "env": {}
    }
  }
}

可用工具

1. get_top_page

从首页获取最新作品列表

参数:

• limit (可选): 获取的作品数量上限（默认: 10）

2. search_works

通过关键词搜索作品

参数:

• q (必填): 搜索关键词
• page (可选): 页码（默认: 1）
• ex_q (可选): 排除关键词
• serial_status (可选): 连载状态（"running", "completed"）
• genre_name (可选): 类型（"fantasy", "action", "sf"等）
• total_review_point_range (可选): 评价数量范围
• total_character_count_range (可选): 字数范围
• published_date_range (可选): 发布日期范围
• last_episode_published_date_range (可选): 更新日期范围
• limit (可选): 获取的作品数量上限（默认: 10）

3. get_work_episodes

获取特定作品的章节列表

参数:

• work_id (必填): 作品ID
• limit (可选): 获取的章节数量上限（默认: 20）

4. get_episode_content

获取特定章节的正文内容

参数:

• work_id (必填): 作品ID
• episode_id (必填): 章节ID

开发

开发环境设置

# 安装包括开发依赖在内的所有依赖
poetry install --with dev

项目结构

kakuyomu-mcp/
├── kakuyomu_mcp/
│   ├── __init__.py
│   └── main.py          # MCP服务器的主要实现
├── kakuyomu.ipynb       # 实现示例和测试案例
├── pyproject.toml       # 项目配置
├── poetry.lock          # 依赖锁定
├── CLAUDE.md           # Claude Code开发指南
└── README.md           # 此文件

示例操作

> 从卡克尤姆的首页选择一个合适的作品，阅读前五章并总结。

● 将从卡克尤姆的首页选择一个作品，阅读其前五章并进行总结。首先整理任务然后执行。

● 更新待办事项
  ⎿  ☐ 从卡克尤姆的首页获取作品列表
     ☐ 选择一个合适的作品
     ☐ 获取选定作品的章节列表
     ☐ 读取前五章的正文
     ☐ 总结读过的内容

● 首先从卡克尤姆的首页获取作品列表。

● 更新待办事项
  ⎿  ☐ 从卡克尤姆的首页获取作品列表
     ☐ 选择一个合适的作品
     ☐ 获取选定作品的章节列表
     ☐ 读取前五章的正文
     ☐ 总结读过的内容

● kakuyomu_mcp:get_top_page (MCP)(limit: 10)…
  ⎿  ID: 16816700429146389370
     标题: 【2/26漫画化第一卷&3/24书籍第三卷发售！】铃的蕾是龙抱花开放　～迷失宫女与美男子宦官的后宫事件簿～【网络版】
     … +36 行（按Ctrl+R展开）
     概述: 让讨厌的上司全部完蛋！转世最强魔法师的蹂躏下克上！

● 已成功从首页获取作品列表。接下来选择一个有趣的作品。“在家里发现了一个不认识的女孩在做家务，但因为可爱所以一直在观察”这个独特的标题吸引了我。

● 更新待办事项
  ⎿  ☒ 从卡克尤姆的首页获取作品列表
     ☐ 选择一个合适的作品
     ☐ 获取选定作品的章节列表
     ☐ 读取前五章的正文
     ☐ 总结读过的内容

● kakuyomu_mcp:get_work_episodes (MCP)(work_id: "16817330651584484057", limit: 10)…
  ⎿  ID: 16817330651584506895
     标题: 第1话　多分是丝丽基
     … +36 行（按Ctrl+R展开）
     发布日期: 2023-07-13T09:00:16Z

● 成功获取了章节列表！现在可以准备读取前五章的正文了。

● 更新待办事项
  ⎿  ☒ 从卡克尤姆的首页获取作品列表
     ☒ 选择一个合适的作品
     ☒ 获取选定作品的章节列表
     ☐ 读取前五章的正文
     ☐ 总结读过的内容

● 现在将并行读取前五章的正文。

● kakuyomu_mcp:get_episode_content (MCP)(work_id: "16817330651584484057", episode_id: "16817330651584506895")…
  ⎿  大学生经常被朋友邀请外出就餐，朋友也会带来其他朋友，不知不觉间就会和陌生人一起吃饭。
     “——啊，你好。我是水月遥斗。我和约克是高中同学。”
     … +41 行（按Ctrl+R展开）
     “但是现在再反应也有些尴尬，她帮忙做家务还是挺有用的，所以最近我一直把她当作妖精丝丽基来接受。”
     ““为什么？””

● kakuyomu_mcp:get_episode_content (MCP)(work_id: "16817330651584484057", episode_id: "16817330659254276779")…
  ⎿  ——作为下酒菜提供的恐怖故事，却意外地引起了极大的恐惧感，两人对我进行了严厉的批评。
     “嗯……”
     … +69 行（按Ctrl+R展开）
     “真的不明白……”
     ——最终，在那天无论怎么考虑都无法缩小候选人的范围。

● kakuyomu_mcp:get_episode_content (MCP)(work_id: "16817330651584484057", episode_id: "16817330659379344364")…
  ⎿  “水月君，这是给三号桌的。”
     “好的。”
     … +78 行（按Ctrl+R展开）
     好吧，现在回去听也是没用的，只能认命了。鼓起勇气，面对未知的高峰时间战斗吧。
     ——不过，那个跟踪狂到底是谁呢？

● kakuyomu_mcp:get_episode_content (MCP)(work_id: "16817330651584484057", episode_id: "16817330659505613634")…
  ⎿  大学是一个比之前的学校更加自由的地方。
     这一点在时间表方面尤为明显。从小学到高中，学生必须遵循学校规定的时间表，没有拒绝的权利。
     … +50 行（按Ctrl+R展开）
     下定决心。为了以防万一，保持高度警惕。考虑到有空袭的可能性，不要忘记把钥匙当作钱包一样握紧。
     基本策略是彻底无视对方，只有在自身安全受到威胁时才反击。带着这样的决心，我转动了家门的把手。

● kakuyomu_mcp:get_episode_content (MCP)(work_id: "16817330651584484057", episode_id: "16817330659554011118")…
  ⎿  保持意识清醒进入玄关。目前还没有看到人影。看来一开始并没有遇到跟踪狂。
     不过看到了一双陌生的女性鞋子，几乎可以确定跟踪狂就是那个人。
     … +72 行（按Ctrl+R展开）
     “……你好。”
     ——结果，跟踪狂在大约两小时后悄悄离开了房间。

● 成功读取了前五章的正文！现在将总结读过的内容。

● 更新待办事项
  ⎿  ☒ 从卡克尤姆的首页获取作品列表
     ☒ 选择一个合适的作品
     ☒ 获取选定作品的章节列表
     ☒ 读取前五章的正文
     ☐ 总结读过的内容

● “在家里发现了一个不认识的女孩在做家务，但因为可爱所以一直在观察”前五章总结

  概要

  这是一部以大学生水月遥斗为主角的现代喜剧作品。他向朋友们抱怨家里有个跟踪狂，但由于没有实际危害，甚至帮忙做家务，所以他称其为“妖精丝丽基”并接受了这种奇怪的情况。

  各章节内容

  第1话「多分是丝丽基」
  - 在朋友聚餐时透露家里有个跟踪狂，但因帮忙做家务而接受
  - 朋友们震惊并批评他
  - 主角性格冷漠且懒散，但很灵巧，会画画并在咖啡馆打工

  第2话「确认丝丽基」
  - 安装隐藏摄像头确认跟踪狂的身份
  - 发现是个年轻女性，暂时松了一口气
  - 观察到她愉快地做家务，更换内衣
  - 决定继续接受她的存在

  第3话「丝丽基是谁」
  - 咖啡馆「海洋雪」的工作场景
  - 经常光顾的乐队「无畏卫士」庆祝唱片合约
  - 思考跟踪狂的身份，但没有头绪
  - 揭示主角社交圈狭窄，记不住人脸

  第4话「丝丽基，存在？」
  - 因大学课程取消提前回家
  - 遇见跟踪狂在家的时间段
  - 决定不报警，而是彻底无视
  - 只在自身安全受威胁时反击

  第5话「不知道丝丽基」
  - 终于与跟踪狂面对面
  - 发现藏在衣橱里的金发美女
  - 彻底无视对方，两小时后跟踪狂离开
  - 身份依然不明，可能是单方面的迷恋

  特点

  - 主角超乎寻常的冷静和合理思维非常有趣
  - 将跟踪狂视为免费家政工的独特设定
  - 日常喜剧元素中带有微妙的紧张感
  - 主角的人际关系稀疏和社会性低下构成了作品的核心

  这是一部相当独特的作品！虽然是关于跟踪狂的故事，但却非常平和，主角的价值观独特且引人入胜。

● 更新待办事项
  ⎿  ☒ 从卡克尤姆的首页获取作品列表
     ☒ 选择一个合适的作品
     ☒ 获取选定作品的章节列表
     ☒ 读取前五章的正文
     ☒ 总结读过的内容

● 所有任务已完成！从卡克尤姆找到了一个有趣的作品，仔细阅读了前五章并进行了总结。这部作品虽然是一部日常喜剧，但因其独特的主角价值观而显得非常有趣。

注意事项

• 如果卡克尤姆的HTML结构发生变化，可能会导致无法正常工作
• 为了避免过度抓取，请适当设置limit参数
• 出现错误时，将返回用户友好的中文消息