About Bestreads MCP Server
Bestreads MCP Server is an MCP server published by dinasaur404 in the Cloud category: remote MCP Server built using Cloudflare Workers.
The repository has 31 stars and 3 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/dinasaur404/BestReads-MCP-ServerThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (8)
addBookReadAdd a book you have read
Parameters not published.
addDislikedAuthorAdd an author you don
Parameters not published.
addDislikedBookAdd a book you didn
Parameters not published.
addFavoriteAuthorAdd an author you enjoy reading
Parameters not published.
addGenreAdd a book genre you enjoy reading
Parameters not published.
clearPreferencesClear all your reading preferences and start fresh
Parameters not published.
getBookRecommendationsGet personalized book recommendations based on your preferences
Parameters not published.
getProfileView your reading history and preferences
Parameters not published.
Ask AI
Ask AI about Bestreads MCP Server
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository yesterday. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
BestReads MCP Server 📚🤔
This is a remote MCP server, built on Cloudflare Workers, that provides personalized book recommendation.
This was built using Cloudflare's guide on deploying remote MCP servers. It uses the Agents SDK to build the MCP server, Durable Objects to persist the user's book preferences, Workers AI to generate book recommendations, and Cloudflare's OAuth Provider library to add GitHub as an authentication provider. The MCP server supports Server-Sent Events (/sse) and Streamable HTTP (/mcp) transport methods.
Get Started
To try it out, connect to https://bestreads.dinas.workers.dev/sse or https://bestreads.dinas.workers.dev/mcp, if your MCP client supports Streamable HTTP. Or, deploy it yourself using the Deploy to Cloudflare button + instructions below.
Available Tools
- getProfile - View your reading history and preferences
- addGenre - Add favorite book genres
- addFavoriteAuthor - Add authors you enjoy
- addBookRead - Track books you've read
- addDislikedBook - Mark books you didn't enjoy
- addDislikedAuthor - Authors to avoid in recommendations
- clearPreferences - Reset all preferences
- getBookRecommendations - Get AI-powered personalized book suggestions
Deploy the MCP server
Setup
- Clone the repository
git clone <your-repo-url>
cd bestreads-mcp-server
npm install
- Create a GitHub OAuth App
- Once you create teh OAuth App, set the Authorization callback URL to https://your-worker-domain.workers.dev/callback
- Note the ClientID and Client Secret. You will add those to your Wrangler file.
- (Optional) Generate Cookie Encryption Key
- Upgrade your
wrangler.tomlfile
[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"
- Deploy to Cloudflare Workers
wrangler deploy
README fetched from the repository yesterday. The original is authoritative.