BestReads MCP Server 📚🤔

BestReads MCP サーバー 📚🤔

これは Cloudflare Workers 上に構築されたリモート MCP サーバーで、パーソナライズされた書籍のおすすめを提供します。

これは、リモート MCP サーバーをデプロイするための Cloudflare のガイドを使用して構築されました。MCP サーバーの構築には Agents SDK を、ユーザーの書籍の好みを永続化するために Durable Objects を、書籍のおすすめを生成するために Workers AI を、認証プロバイダーとして GitHub を追加するために Cloudflare の OAuth Provider ライブラリを使用しています。この MCP サーバーは、Server-Sent Events (/sse) と Streamable HTTP (/mcp) のトランスポート方式をサポートしています。

はじめに

試してみるには、https://bestreads.dinas.workers.dev/sse または https://bestreads.dinas.workers.dev/mcp に接続してください (お使いの MCP クライアントが Streamable HTTP をサポートしている場合)。あるいは、Deploy to Cloudflare ボタンと以下の手順を使用して、ご自身でデプロイすることもできます。

利用可能なツール

• getProfile - 読書履歴と好みを表示します
• addGenre - お気に入りの書籍ジャンルを追加します
• addFavoriteAuthor - 好きな著者を追加します
• addBookRead - 読んだ本を記録します
• addDislikedBook - 楽しめなかった本をマークします
• addDislikedAuthor - おすすめから除外したい著者
• clearPreferences - すべての好みをリセットします
• getBookRecommendations - AI によるパーソナライズされた書籍の提案を取得します

MCP サーバーをデプロイする

セットアップ

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

  git clone <your-repo-url>
  cd bestreads-mcp-server
  npm install

2. GitHub OAuth Appを作成します

• OAuth App を作成したら、Authorization callback URL を https://your-worker-domain.workers.dev/callback に設定します
• ClientID と Client Secret を控えておきます。これらを Wrangler ファイルに追加します。
• (オプション) Cookie 暗号化キーを生成します

3. wrangler.toml ファイルをアップグレードします

[vars]
GITHUB_CLIENT_ID = "your_github_client_id"
GITHUB_CLIENT_SECRET = "your_github_client_secret"
COOKIE_ENCRYPTION_KEY = "your_32_byte_hex_key"

[[kv_namespaces]]
binding = "OAUTH_KV"
id = "your_kv_namespace_id"

[[durable_objects.bindings]]
name = "MCP_OBJECT"
class_name = "MyMCP"

[[durable_objects.bindings]]
name = "USER_BOOK_PREFERENCES"
class_name = "UserBookPreferences"

4. Cloudflare Workers にデプロイします wrangler deploy