RedNote MCP

RedNote MCP

Serviço MCP para acesso a conteúdo do RedNote

https://github.com/user-attachments/assets/06b2c67f-d9ed-4a30-8f1d-9743f3edaa3a

Início Rápido

Antes de começar, certifique-se de que o ambiente playwright esteja instalado:

npx playwright install

Instalando via Smithery

Para instalar o rednote-mcp para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @JonaFly/rednote-mcp --client claude

Instalação global via NPM

# 全局安装
npm install -g rednote-mcp

# 初始化登录，会自动记录cookie到 ~/.mcp/rednote/cookies.json
rednote-mcp init

Instalação a partir do código-fonte

# 克隆项目
git clone https://github.com/ifuryst/rednote-mcp.git
cd rednote-mcp

# 安装依赖
npm install

# 全局安装（可选，方便命令行调用）
npm install -g .

# 或者直接运行，如初始化登录
npm run dev -- init

Recursos

• Gerenciamento de autenticação (com suporte a persistência de Cookie)
• Busca de notas por palavras-chave
• Ferramenta de inicialização via linha de comando
• Acesso ao conteúdo de notas via URL
• Acesso ao conteúdo de comentários via URL

Instruções de Uso

1. Inicialização do Login

Na primeira utilização, é necessário inicializar o login:

rednote-mcp init
# 或者直接从源码run
npm run dev -- init
# 或者mcp-client里选择login

Após executar este comando:

1. Uma janela do navegador será aberta automaticamente
2. Será redirecionado para a página de login do RedNote
3. Conclua o login manualmente
4. Após o login bem-sucedido, o Cookie será salvo automaticamente no arquivo ~/.mcp/rednote/cookies.json

2. Configurando o MCP Server no Cursor

Adicione a seguinte configuração no settings.json do Cursor:

{
  "mcpServers": {
    "RedNote MCP": {
      "command": "rednote-mcp",
      "args": [
        "--stdio"
      ]
    }
  }
}

Ou use o modo npx:

{
  "mcpServers": {
    "RedNote MCP": {
      "command": "npx",
      "args": [
        "rednote-mcp",
        "--stdio"
      ]
    }
  }
}

Explicação da configuração:

• command: pode ser o comando rednote-mcp instalado globalmente, ou usar npx para executar diretamente
• args: deve incluir o parâmetro --stdio para suportar o modo de comunicação do Cursor

Guia de Desenvolvimento

Requisitos de Ambiente

• Node.js >= 16
• npm >= 7

Fluxo de Desenvolvimento

# 安装依赖
npm install

# 构建项目
npm run build

# 开发模式运行
npm run dev

# 运行测试
npm test

Depuração com o MCP Inspector

O MCP Inspector é uma ferramenta para depurar servidores MCP, que ajuda os desenvolvedores a inspecionar e validar o comportamento do servidor MCP. Use o seguinte comando para iniciar:

npx @modelcontextprotocol/inspector npx rednote-mcp --stdio

Este comando irá:

1. Iniciar a ferramenta MCP Inspector
2. Executar o serviço rednote-mcp através do Inspector
3. Fornecer uma interface interativa para inspecionar requisições e respostas
4. Ajudar na depuração e validação da implementação do protocolo MCP

Observações

1. Na primeira utilização, é obrigatório executar o comando init para fazer login
2. O arquivo de Cookie contém informações sensíveis; evite vazamentos
3. Recomenda-se atualizar o Cookie periodicamente para evitar expiração
4. Certifique-se de que o ambiente Node.js esteja instalado corretamente

Guia de Contribuição

1. Faça um fork deste repositório
2. Crie sua branch de funcionalidade (git checkout -b feature/AmazingFeature)
3. Envie suas alterações (git commit -m 'Add some AmazingFeature')
4. Envie para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

Licença

Licença MIT - consulte o arquivo LICENSE para mais detalhes