Hardcover MCP

🚀 ハードカバーMCP

Hardcover.appのGraphQL APIに対する読み取り専用アクセスを提供するモデルコンテキストプロトコル（MCP）サーバーです。ツールはbooks.*、users.*、series.*の名前空間で管理され、安全で低容量のクエリを行うためのリソースとプロンプトが用意されています。

このサーバーは非公式でコミュニティによってメンテナンスされており、Hardcover.appとは関係ありません。

🚀 クイックスタート

このサーバーを使うことで、Hardcover.appのGraphQL APIに読み取り専用でアクセスできます。以下の手順に沿ってセットアップしてください。

✨ 主な機能

• Hardcover.appのGraphQL APIに読み取り専用でアクセスする機能を提供します。
• books.*、users.*、series.*の名前空間でツールを管理します。
• 安全で低容量のクエリを行うためのリソースとプロンプトを提供します。

📦 インストール

# オプションA: uvを使う場合（推奨）
uv pip install -e .

# オプションB: pipを使う場合
python -m venv .venv
source .venv/bin/activate
pip install -e .

📚 ドキュメント

トランスポートプロトコル

このサーバーは現在、トランスポートプロトコルとしてSTDIOのみをサポートしています。

使用方法

1. https://hardcover.app/account/api からAPIキーを取得します。表示された値をそのままコピーしてください（すでにBearer で始まっています）。
2. サーバーに対してエクスポートします。

export HARDCOVER_API_KEY="Bearer <your-token>"

サーバーを直接起動する

3. MCPサーバーを起動します。

uv run src/hardcover_mcp/main.py

AIチャット用にSTDIOを設定する

Codex

[mcp_servers.hardcover_mcp]
command = "uv"
args = ["run", "src/hardcover_mcp/main.py"]
env = { "HARDCOVER_API_KEY" = "API KEY heRE" }
cwd = "full_path_to/hardcover_mcp"

サーバーはbooks.*、users.*、series.*のツール名前空間を登録し、hardcover/tag-categoriesのようなリソースとhardcover/fantasy-this-yearのような使用プロンプトを提供します。

テストスイートを実行する

pytest

トラブルシューティング

• HARDCOVER_API_KEY environment variable is required：サーバーを起動するのと同じシェルで変数が設定されていることを確認してください。先頭のBearer 接頭辞を含めてください。
• Hardcover API returned an error response または401/403：トークンが有効で期限切れでないことを確認してください。
• 応答が遅いまたはタイムアウトする：limit/offset引数を減らしてください；APIにはレート制限があります。limit<=10から始めてください。
• SSL/HTTPトランスポートの問題：ローカルのネットワーク/プロキシ設定を確認し、安定した接続で再試行してください。

🔧 技術詳細

必要条件

• Python 3.11以上
• https://hardcover.app/account/api から取得したHardcover APIキー（読み取り専用のベアラートークン）