BestReads
Remote MCP Server built using Cloudflare Workers.
What is BestReads?
BestReads is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to remote mcp server built using cloudflare workers.
Remote MCP Server built using Cloudflare Workers.
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Remote MCP Server built using Cloudflare Workers.
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx bestreads-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use BestReads
BestReads is a remote MCP server built on Cloudflare Workers and Durable Objects that acts as a personalized book recommendation engine. It tracks your reading history, favorite genres and authors, and books you've disliked, then uses that context to generate tailored book suggestions. Deployed at the edge with global low latency, it demonstrates how Cloudflare's serverless platform can host stateful MCP servers accessible from any MCP client.
Prerequisites
- A Cloudflare account with Workers and Durable Objects enabled (paid plan required for Durable Objects)
- Node.js 18+ and Wrangler CLI (npm install -g wrangler) for self-hosting
- GitHub OAuth app credentials (GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET) if deploying your own instance
- An MCP-compatible client such as Claude Desktop or Cursor that supports SSE or Streamable HTTP transport
Connect to the hosted instance (quickest path)
The server is publicly deployed. Add it to your MCP client configuration using the SSE or Streamable HTTP endpoint — no installation required.
Configure your MCP client to use the remote server
Add the BestReads remote server to your MCP client configuration. Use mcp-remote or a native SSE transport to connect to the deployed Cloudflare Workers endpoint.
{
"mcpServers": {
"bestreads": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://bestreads.dinas.workers.dev/mcp"]
}
}
}Or self-host: clone and install dependencies
To deploy your own instance, clone the repository and install Node.js dependencies.
git clone https://github.com/dinasaur404/BestReads-MCP-Server.git
cd BestReads-MCP-Server
npm installConfigure Cloudflare secrets for self-hosted deployment
Set the required secrets via Wrangler. These include GitHub OAuth credentials for user authentication and a cookie encryption key.
wrangler secret put GITHUB_CLIENT_ID
wrangler secret put GITHUB_CLIENT_SECRET
wrangler secret put COOKIE_ENCRYPTION_KEYDeploy to Cloudflare Workers
Deploy your own instance to Cloudflare's edge network. After deployment, update your MCP client config to point to your Workers URL.
wrangler deployBestReads Examples
Client configuration
Connect to the public BestReads MCP server via mcp-remote using the Streamable HTTP endpoint.
{
"mcpServers": {
"bestreads": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://bestreads.dinas.workers.dev/mcp"]
}
}
}Prompts to try
Example interactions for building your reading profile and getting recommendations.
- "Add science fiction to my favorite genres"
- "I just finished reading 'The Three-Body Problem' — add it to my reading history"
- "Add Isaac Asimov as one of my favorite authors"
- "I didn't enjoy 'Twilight' — mark it as a disliked book"
- "Based on my reading history, what books should I read next?"Troubleshooting BestReads
mcp-remote cannot connect to the Workers endpoint
Verify the URL is reachable by opening https://bestreads.dinas.workers.dev/mcp in a browser. If you are self-hosting, confirm your wrangler deploy succeeded and the Durable Objects bindings (OAUTH_KV, MCP_OBJECT, USER_BOOK_PREFERENCES) are correctly configured in wrangler.toml.
Durable Objects binding errors during self-hosted deployment
Durable Objects require a Cloudflare paid plan. Ensure your account has Durable Objects enabled and that the bindings in wrangler.toml match the class names exported from your worker. Run 'wrangler deploy --dry-run' to validate configuration before deploying.
Authentication fails during GitHub OAuth flow
Verify GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET are set correctly as Wrangler secrets. The GitHub OAuth app's callback URL must match your Workers domain exactly (e.g., https://your-worker.workers.dev/callback). Check the OAuth app settings in your GitHub Developer settings.
Frequently Asked Questions about BestReads
What is BestReads?
BestReads is a Model Context Protocol (MCP) server that remote mcp server built using cloudflare workers. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install BestReads?
Follow the installation instructions on the BestReads GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with BestReads?
BestReads works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is BestReads free to use?
Yes, BestReads is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
BestReads Alternatives — Similar Cloud Services Servers
Looking for alternatives to BestReads? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up BestReads in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use BestReads?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.