BestReads MCP Server 📚🤔

这是一个基于Cloudflare Workers构建的远程MCP服务器，提供个性化的图书推荐。

该服务器是根据Cloudflare的指南部署远程MCP服务器而构建的。它使用了Agents SDK来构建MCP服务器，使用Durable Objects来持久化用户的图书偏好，使用Workers AI生成图书推荐，并使用Cloudflare的OAuth Provider库添加GitHub作为身份验证提供者。此MCP服务器支持Server-Sent Events (/sse)和Streamable HTTP (/mcp)传输方法。

开始使用

要试用此服务，请连接到https://bestreads.dinas.workers.dev/sse或https://bestreads.dinas.workers.dev/mcp（如果您的MCP客户端支持Streamable HTTP）。或者，您可以按照下方的“部署到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应用

• 创建OAuth应用后，将授权回调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