WeRead

Acesse sua estante de livros do WeChat Reading (微信读书), notas, destaques e resenhas.

GitHub
571
Experimente este MCPPatrocinado

Documentação

MaxKB

Uma ferramenta que fornece serviços MCP para o WeRead

The MIT License Forks Official Stars Experience

O WeRead MCP Server é uma ferramenta que fornece serviços MCP (Model Context Protocol) para o WeRead, permitindo que dados de livros, notas e marcações do WeRead sejam disponibilizados para clientes de modelos de linguagem grandes que suportam MCP, como Cursor e Claude Desktop.

Recursos

  • Obter informações da estante do WeRead
  • Pesquisar livros na estante
  • Obter notas e marcações de um livro
  • Obter resenhas populares de um livro
  • Suporte para organizar notas e marcações por capítulo
  • Integração perfeita com clientes LLM que suportam o protocolo MCP

Principais ferramentas

  1. get_bookshelf - Obtém todos os livros da estante do usuário

    • Retorna informações básicas dos livros, incluindo título, autor, tradutor e categoria

  2. search_books - Pesquisa livros na estante do usuário por palavras-chave

    • Suporte para correspondência difusa e exata
    • Opção de incluir informações detalhadas
    • Permite definir o número máximo de resultados

  3. get_book_notes_and_highlights - Obtém todas as marcações e notas de um livro específico

    • Suporte para organizar resultados por capítulo
    • Suporte para filtrar estilos de marcação
    • Retorna dados estruturados para facilitar a compreensão pelo LLM

  4. get_book_best_reviews - Obtém resenhas populares de um livro específico

    • Suporte para definir a quantidade de resultados
    • Suporte para navegação paginada
    • Inclui avaliação, número de curtidas e informações do revisor

Instalação e uso

Pré-requisitos

  • Node.js 16.x ou superior
  • Conta WeRead e Cookie válido

Tutorial de instalação

Consulte:

Integração com Claude Desktop

Existem várias maneiras de integrar com o Claude Desktop:

Método 1: Usando npx (mais simples, recomendado)

  1. Abra o Claude Desktop
  2. Vá para Configurações -> Configuração MCP
  3. Adicione a ferramenta, usando a seguinte configuração JSON: 
    {
  "mcpServers": {
    "mcp-server-weread": {
      "command": "npx",
      "args": ["-y", "mcp-server-weread"],
      "env": {
        // 方式1：使用Cookie Cloud（推荐）
        "CC_URL": "https://cc.chenge.ink",  // Cookie Cloud的URL
        "CC_ID": "您的ID",                   // Cookie Cloud的ID
        "CC_PASSWORD": "您的密码"            // Cookie Cloud的密码
        
        // 或方式2：直接提供Cookie
        // "WEREAD_COOKIE": "您的微信读书Cookie"
      }
    }
  }
}

Método 2: Instalação global

  1. Instale o pacote globalmente:

    npm install -g mcp-server-weread

  2. Use na configuração do Claude:

    {
  "mcpServers": {
    "mcp-server-weread": {
      "command": "mcp-server-weread",
      "env": {
        // 同上方式配置环境变量
      }
    }
  }
}

Dica: Fornecer variáveis de ambiente diretamente na configuração do Claude é mais conveniente, sem necessidade de configurar o arquivo .env, recomendado.

Configuração do CookieCloud

Para resolver o problema de cookies que expiram com frequência, exigindo nova obtenção e atualização das variáveis de ambiente, este projeto suporta o serviço CookieCloud para sincronizar e atualizar cookies automaticamente. O CookieCloud é uma ferramenta de sincronização de cookies entre navegadores de código aberto, com suporte para servidor próprio.

Passos de configuração:

Instale a extensão do navegador Loja Edge: CookieCloud para Edge Loja Chrome: CookieCloud para Chrome

Configurar o plugin CookieCloud

Endereço do servidor: use o servidor padrão https://cc.chenge.ink ou preencha com o endereço do seu próprio servidor Clique em "Gerar senha automaticamente" No campo de palavras-chave de sincronização de domínio, preencha "weread" Clique em "Salvar" e depois em "Sincronizar manualmente" para garantir que a configuração seja aplicada [Opcional] Se precisar de manutenção automática do plugin, preencha https://weread.qq.com na seção de manutenção, e o plugin atualizará o Cookie automaticamente

Configure as variáveis do CookieCloud no MCP Json: CC_URL=Endereço do seu servidor CookieCloud (ou use meu endereço de servidor padrão https://cc.chenge.ink) CC_ID=Seu UUID de usuário do CookieCloud CC_PASSWORD=Sua senha do CookieCloud Observação: Após configurar o CookieCloud, o sistema priorizará o uso do CookieCloud para obter o Cookie; somente se falhar, usará o valor da variável de ambiente WEREAD_COOKIE.

Como obter o Cookie

O Cookie do WeRead pode ser obtido seguindo os passos abaixo:

  1. Use o navegador Chrome para acessar a versão web do WeRead e fazer login
  2. Pressione F12 para abrir as ferramentas de desenvolvedor e mude para a aba Network
  3. Atualize a página e encontre a requisição para weread.qq.com na lista de requisições
  4. No cabeçalho Headers, encontre o campo Cookie e copie todo o conteúdo
  5. Adicione o conteúdo copiado à variável WEREAD_COOKIE no MCP Json ou no arquivo .env

Exemplos de uso

Abaixo estão alguns exemplos de conversas com LLM:

Obter informações da estante

用户: 帮我查看我的微信读书书架
LLM: 我将获取您的微信读书书架信息。
[LLM调用get_bookshelf工具]
我从您的微信读书书架获取到了208本书籍。以下是部分书籍：
1. 《隐藏的自我》- 大卫·伊格曼
2. 《思考，快与慢》- 丹尼尔·卡尼曼
3. 《人类简史》- 尤瓦尔·赫拉利
...

Pesquisar um livro específico

用户: 帮我找关于心理学的书
LLM: 我将搜索您书架上与心理学相关的书籍。
[LLM调用search_books工具，参数为keyword="心理学"]
在您的书架上，我找到了3本与心理学相关的书籍：
1. 《思考，快与慢》- 丹尼尔·卡尼曼（进度：75%）
2. 《乌合之众》- 古斯塔夫·勒庞（进度：50%）
3. 《心理学与生活》- 理查德·格里格（进度：30%）
您想了解哪一本书的更多信息？

Obter notas e marcações

用户: 帮我整理《思考，快与慢》这本书的笔记
LLM: 我将获取《思考，快与慢》的笔记和划线。
[LLM调用search_books工具，找到书籍ID]
[LLM调用get_book_notes_and_highlights工具]
以下是您在《思考，快与慢》中的笔记和划线（按章节组织）：

第一章：系统1和系统2
- 划线：「系统1的运行是无意识且快速的，不怎么费脑力，没有感觉，完全处于自主控制状态。」
- 您的笔记：「系统1负责直觉和快速判断，系统2负责缓慢的理性思考。」

第三章：锚定效应
- 划线：「锚定效应指的是在不确定情境下进行数字估计时，会过度受到事先接触的不相干数字的影响。」
...

Obter resenhas populares

用户: 这本《原则》有哪些热门书评？
LLM: 我会为您查找《原则》的热门书评。
[LLM调用search_books工具，找到书籍ID]
[LLM调用get_book_best_reviews工具]
以下是《原则》的热门书评：

1. 评论者"思考者"（评分：5星）：
   "这是一本关于如何思考的书。达利欧将自己多年的经验总结为可操作的原则，帮助我们做出更好的决策。特别喜欢他关于'痛苦+反思=进步'的观点，非常实用。"
   👍 182 | 💬 23

2. 评论者"投资学习者"（评分：4星）：
   "桥水基金创始人的思想精华，值得反复阅读。书中的工作原则部分对管理者特别有帮助，建议先读生活原则，再读工作原则。"
   👍 94 | 💬 12
...

Nove, Links de interesse

  • mcp-server-weread : 🚀Uma ferramenta que fornece serviços MCP (Model Context Protocol) para o WeRead, permitindo que dados de livros, notas e marcações do WeRead sejam disponibilizados para clientes de modelos de linguagem grandes que suportam MCP, como Claude Desktop.
  • CodeCanvas : 📚Este repositório é um resumo técnico da jornada de aprendizado do autor Cang He ao longo de anos de desenvolvimento Java em primeira linha na internet, com o objetivo de fornecer um tutorial claro e detalhado, com foco no conteúdo essencial de Java. 💪🏻
  • PmHub : 🔥PmHub é um sistema de gerenciamento de projetos inteligente baseado em microsserviços com SpringCloud & LLM. Este projeto visa ajudar desenvolvedores a dominar rapidamente o design arquitetural e o fluxo de desenvolvimento de projetos de microsserviços/distribuídos. Se você deseja obter uma oferta satisfatória em recrutamento de estágio ou no mercado, o PmHub é uma excelente escolha.

Dez, Agradecimentos

Este projeto é um fork do projeto mcp-server-weread de ChenyqThu, com algumas pequenas modificações, e de repente ficou 🔥. Peço que todos também dêem uma estrela no repositório original do autor no GitHub. Além disso, sincronizarei as novas atualizações do ChenyqThu, e o projeto continuará mantendo o tutorial atualizado. Agradeço a todos pelo carinho.

Onze, Gráfico de tendência de estrelas

Star History Chart

Doze, Conta pública

Pesquise 苍何 no WeChat ou escaneie o QR code abaixo para seguir a conta pública original do Cang He. Responda AI para discutir IA com mais de 5000 amigos e aprender MCP juntos.

苍何微信公众号

Treze, Licença

MIT License (MIT)

O aviso de direitos autorais acima e este aviso de permissão devem ser incluídos em todas as cópias ou partes substanciais do Software.

Copyright (c) 2025-2026 mcp-server-weread