Kakuyomu MCP Server

小説投稿サイト「カクヨム」のコンテンツを読み込むためのMCP（Model Context Protocol）サーバーです。LLMエージェントがカクヨムの作品検索、エピソード一覧取得、本文読み込みなどを行えるツールを提供します。

機能

• 作品検索: キーワード検索と詳細フィルタリング（ジャンル、評価数、文字数、公開日等）
• トップページ取得: 最新作品一覧の取得
• エピソード一覧: 特定作品のエピソード情報取得
• 本文読み込み: 特定エピソードの本文を取得

🚀 簡単に試してみる

に公開されているイメージを使えば、すぐに試せます。

Claude Codeで使う

# dockerhubからpull
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からpull
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 (optional): 取得する作品数の上限（デフォルト: 10）

2. search_works

キーワードで作品を検索

パラメータ:

• q (required): 検索キーワード
• page (optional): ページ数（デフォルト: 1）
• ex_q (optional): 除外キーワード
• serial_status (optional): 連載状態（"running", "completed"）
• genre_name (optional): ジャンル（"fantasy", "action", "sf"など）
• total_review_point_range (optional): 評価数範囲
• total_character_count_range (optional): 文字数範囲
• published_date_range (optional): 作品公開日範囲
• last_episode_published_date_range (optional): 作品更新日範囲
• limit (optional): 取得する作品数の上限（デフォルト: 10）

3. get_work_episodes

特定作品のエピソード一覧を取得

パラメータ:

• work_id (required): 作品ID
• limit (optional): 取得するエピソード数の上限（デフォルト: 20）

4. get_episode_content

特定エピソードの本文を取得

パラメータ:

• work_id (required): 作品ID
• episode_id (required): エピソード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           # このファイル

動作例

> カクヨムのトップページから適当な作品を選択し、その作品の冒頭5話を読んでまとめてください。

● カクヨムのトップページから作品を選んで冒頭5話を読み、まとめる作業を行うのだ。まずはタスクを整理してから実行するのだ。

● Update Todos
  ⎿  ☐ カクヨムのトップページから作品一覧を取得
     ☐ 適当な作品を1つ選択
     ☐ 選択した作品のエピソード一覧を取得
     ☐ 冒頭5話の本文を読み込み
     ☐ 読んだ内容をまとめて報告

● まずはカクヨムのトップページから作品を取得するのだ。

● Update Todos
  ⎿  ☐ カクヨムのトップページから作品一覧を取得
     ☐ 適当な作品を1つ選択
     ☐ 選択した作品のエピソード一覧を取得
     ☐ 冒頭5話の本文を読み込み
     ☐ 読んだ内容をまとめて報告

● kakuyomu_mcp:get_top_page (MCP)(limit: 10)…
  ⎿  ID: 16816700429146389370
     タイトル: 【2/26コミカライズ１巻＆3/24書籍３巻発売！】鈴の蕾は龍に抱かれ花ひらく　～迷子宮女と美貌の宦官の後宮事件帳～【WEB版】
     … +36 lines (ctrl+r to expand)
     キャッチフレーズ: ムカつく上司は全員ざまぁ！　転生した最強魔法使いの蹂躙下剋上！

● トップページから作品一覧を取得できたのだ。では面白そうな作品を1つ選ぶのだ。「家で知らない娘が家事をしているっぽい。でも可愛かったから様子を見てる」というユニークなタイトルの作品を選んでみるのだ。

● Update Todos
  ⎿  ☒ カクヨムのトップページから作品一覧を取得
     ☐ 適当な作品を1つ選択
     ☐ 選択した作品のエピソード一覧を取得
     ☐ 冒頭5話の本文を読み込み
     ☐ 読んだ内容を

... [View full README on GitHub](https://github.com/106-/kakuyomu-mcp#readme)