MCP Getgather Goodreads

🚀 goodreads - mcp

Goodreads MCP統合のためのCLIツールです。このツールを使用することで、Goodreadsの書籍情報を簡単に取得できます。

🚀 クイックスタート

このセクションでは、goodreads - mcpのインストールと使用方法について説明します。

📦 インストール

前提条件

uvがインストールされていない場合は、まず以下のコマンドでインストールしてください。

# macOSとLinuxの場合
curl -LsSf https://astral.sh/uv/install.sh | sh

# またはpipを使用する場合
pip install uv

リポジトリのクローン

以下のコマンドを使用してリポジトリをクローンし、ディレクトリに移動します。

git clone https://github.com/getgather-hub/mcp-getgather-goodreads.git
cd mcp-getgather-goodreads

💻 使用例

基本的な使用法

CLIコマンド

以下のコマンドを使用して、Goodreadsから書籍を取得できます。

# Goodreadsから書籍を取得する
uv run goodreads-mcp get-books --email your-email@example.com --password your-password

# カスタムホストを使用する（デフォルト: 127.0.0.1:8000）
uv run goodreads-mcp get-books --email your-email@example.com --password your-password --host myserver.com

Claude Desktopでの使用方法

Claude Desktopでgoodreads - mcpをMCPサーバーとして使用するには、以下の手順を実行してください。

1. まず、リポジトリをクローンします。

   git clone https://github.com/getgather-hub/mcp-getgather-goodreads.git
   cd mcp-getgather-goodreads
   

2. Claude Desktopの設定ファイルを編集して設定を行います。

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json

3. 以下の設定を追加します。

   {
     "mcpServers": {
       "goodreads": {
         "command": "uv",
         "args": [
           "--directory",
           "/path/to/mcp-getgather-goodreads",
           "run",
           "goodreads-mcp"
         ],
         "env": {
           "GOODREADS_EMAIL": "your-email@example.com",
           "GOODREADS_PASSWORD": "your-password",
           "GETGATHER_URL": "127.0.0.1:8000"
         }
       }
     }
   }
   

   注意: /path/to/mcp-getgather-goodreadsを実際にクローンしたリポジトリのパスに置き換えてください。

4. Claude Desktopを再起動します。

高度な使用法

利用可能なMCPツール

設定が完了すると、Claudeで以下のツールが利用可能になります。

• get_goodreads_books: Goodreadsライブラリから書籍を取得します。

環境変数

MCPサーバーには以下の環境変数が必要です。