Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Kakuyomu MCP Serversearch for fantasy novels with over 1000 reviews"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Kakuyomu MCP Server
小説投稿サイト「カクヨム」のコンテンツを読み込むためのMCP(Model Context Protocol)サーバーです。LLMエージェントがカクヨムの作品検索、エピソード一覧取得、本文読み込みなどを行えるツールを提供します。
機能
作品検索: キーワード検索と詳細フィルタリング(ジャンル、評価数、文字数、公開日等)
トップページ取得: 最新作品一覧の取得
エピソード一覧: 特定作品のエピソード情報取得
本文読み込み: 特定エピソードの本文を取得
Related MCP server: pymupdf4llm-mcp
🚀 簡単に試してみる
に公開されているイメージを使えば、すぐに試せます。
Claude Codeで使う
Claude Desktopで使う
claude_desktop_config.jsonに以下を追加し、Claude Desktopを再起動します:
インストール
必要な環境
Python 3.10以上
Poetry
セットアップ
使用方法
サーバーの起動
Dockerで実行
Claude Code (MCP) での利用
.mcp.jsonファイルに以下の設定を追加:
Dockerを使用する場合:
利用可能なツール
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): 作品IDlimit(optional): 取得するエピソード数の上限(デフォルト: 20)
4. get_episode_content
特定エピソードの本文を取得
パラメータ:
work_id(required): 作品IDepisode_id(required): エピソードID
開発
開発環境のセットアップ
プロジェクト構造
動作例
注意事項
カクヨムのHTML構造変更により動作しなくなる可能性があります
過度なスクレイピングを避けるため、
limitパラメータを適切に設定してくださいエラー時は日本語でユーザーフレンドリーなメッセージを返します