作者 onebirdrocks · onebirdrocks/ebook-mcp
ClaudeをEPUB・PDFライブラリに接続すると、メタデータ、目次、チャプター本文を構造化された形式で取得でき、正確な引用や要約が可能になります。
ebook-mcpは、PythonのEPUB/PDFライブラリをMCPツールとしてラップします。汎用的な「ファイル読み込み」とは異なり、目次やチャプターの区切りを公開するため、Claudeは500ページ全体をコンテキストに投入するのではなく、必要なチャプターだけを取得できます。
uv pip install -e .でインストール%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"ebook": {
"command": "uvx",
"args": [
"ebook-mcp"
],
"_inferred": true
}
}
}Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。
{
"mcpServers": {
"ebook": {
"command": "uvx",
"args": [
"ebook-mcp"
],
"_inferred": true
}
}
}Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。
{
"mcpServers": {
"ebook": {
"command": "uvx",
"args": [
"ebook-mcp"
],
"_inferred": true
}
}
}Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。
{
"mcpServers": {
"ebook": {
"command": "uvx",
"args": [
"ebook-mcp"
],
"_inferred": true
}
}
}Claude Desktop と同じ形式。Windsurf を再起動して反映。
{
"mcpServers": [
{
"name": "ebook",
"command": "uvx",
"args": [
"ebook-mcp"
]
}
]
}Continue はマップではなくサーバーオブジェクトの配列を使用。
{
"context_servers": {
"ebook": {
"command": {
"path": "uvx",
"args": [
"ebook-mcp"
]
}
}
}
}context_servers に追加。保存時に Zed がホットリロード。
claude mcp add ebook -- uvx ebook-mcpワンライナー。claude mcp list で確認、claude mcp remove で削除。
使うタイミング： 「あの本にXについて書いてあったはず…」——正確な引用が必要だけど、ページをめくる気力がないとき。
結果： 2分で引用可能な一節が手に入る。
使うタイミング： その本を実際に読むかどうか判断したいとき、または読了後の復習が必要なとき。
結果： 共有や見返し用の1〜2ページのブックダイジェスト。
使うタイミング： ライブラリに500冊の電子書籍があり、タイトルや著者のメタデータが欠落しているものを見つけたいとき。
結果： メタデータの衛生チェックが素早く完了。
| ツール | 入力 | 呼び出すタイミング | コスト |
|---|---|---|---|
| get_metadata | path: str | 書籍の最初の確認時に呼び出す | free |
| get_toc | path: str | チャプター本文を取得する前に呼び出す | free |
| get_chapter | path, chapter_id or id_range | 特定のチャプターを読み込むときに呼び出す | free |
| get_pages | path, from_page, to_page (PDF only) | PDFのページ範囲を抽出するときに呼び出す | free |
Unable to parse PDFスキャン/画像のみのPDFにはテキストレイヤーがありません。先にocrmypdfを実行してください。
pdftotext input.pdf - | headEPUB chapter ID not foundIDは目次から正確に取得されます。先にget_tocを呼び出してください。
Large PDF makes get_chapter timeoutより小さいページ範囲でget_pagesを使用し、バッチ処理してください。
| 代替案 | 代わりに使う場面 | トレードオフ |
|---|---|---|
| Calibre + custom script | Calibreとの完全な統合が必要な場合 | セットアップが多い。MCPラッパーなし |
| pdfplumber / pymupdf directly | 独自のツールを構築する場合 | MCPラッパーを自分で構築する必要がある |