RedNote MCP

RedNote MCP

Servicio MCP para acceder al contenido de RedNote

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

Inicio rápido

Antes de comenzar, asegúrese de tener instalado el entorno de playwright:

npx playwright install

Instalación mediante Smithery

Para instalar rednote-mcp para Claude Desktop automáticamente mediante Smithery:

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

Instalación global de NPM

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

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

Instalación desde el código fuente

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

# 安装依赖
npm install

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

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

Características

• Gestión de autenticación (compatible con persistencia de cookies)
• Búsqueda de notas por palabras clave
• Herramienta de inicialización por línea de comandos
• Acceso al contenido de notas mediante URL
• Acceso al contenido de comentarios mediante URL

Instrucciones de uso

1. Inicialización del inicio de sesión

La primera vez que se usa, es necesario inicializar el inicio de sesión:

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

Después de ejecutar este comando:

1. Se abrirá automáticamente una ventana del navegador
2. Se redirigirá a la página de inicio de sesión de RedNote
3. Complete manualmente la operación de inicio de sesión
4. Después de iniciar sesión correctamente, la cookie se guardará automáticamente en el archivo ~/.mcp/rednote/cookies.json

2. Configurar el servidor MCP en Cursor

Agregue la siguiente configuración en settings.json de Cursor:

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

O use el método npx:

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

Descripción de la configuración:

• command: puede ser el comando rednote-mcp después de la instalación global, o usar npx para ejecutarlo directamente
• args: debe incluir el parámetro --stdio para admitir el método de comunicación de Cursor

Guía de desarrollo

Requisitos del entorno

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

Flujo de desarrollo

# 安装依赖
npm install

# 构建项目
npm run build

# 开发模式运行
npm run dev

# 运行测试
npm test

Depuración con MCP Inspector

MCP Inspector es una herramienta para depurar servidores MCP que ayuda a los desarrolladores a inspeccionar y verificar el comportamiento del servidor MCP. Inícielo con el siguiente comando:

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

Este comando:

1. Inicia la herramienta MCP Inspector
2. Ejecuta el servicio rednote-mcp a través de Inspector
3. Proporciona una interfaz interactiva para inspeccionar solicitudes y respuestas
4. Ayuda a depurar y verificar la implementación del protocolo MCP

Precauciones

1. La primera vez que se use, debe ejecutar el comando init para iniciar sesión
2. El archivo de cookies contiene información sensible; evite su divulgación
3. Se recomienda actualizar las cookies periódicamente para evitar que caduquen
4. Asegúrese de tener instalado correctamente el entorno Node.js

Guía de contribución

1. Haga un fork de este repositorio
2. Cree su rama de características (git checkout -b feature/AmazingFeature)
3. Confirme sus cambios (git commit -m 'Add some AmazingFeature')
4. Haga push a la rama (git push origin feature/AmazingFeature)
5. Abra un Pull Request

Licencia

Licencia MIT: consulte el archivo LICENSE