Prototipo de servidor Yonote MCP

Este es un proyecto MVP de un servidor MCP para el servicio Yonote, una alternativa a Notion. El servidor proporciona herramientas API para interactuar con documentos y colecciones de Yonote.

Características

• Lista de documentos y colecciones de Yonote

• Obtenga información detallada sobre un documento

• Expone herramientas a través del marco FastMCP

Related MCP server: mcp-discord-chat MCP server

Requisitos

• Python 3.13+

• Credenciales de la API de Yonote

• Los siguientes paquetes de Python (consulte pyproject.toml ):

  • fast-agent-mcp>=0.2.23

  • requests>=2.32.3

  • python-dotenv (para cargar variables de entorno)

• uv para la gestión de dependencias

Configuración

Instalación mediante herrería

Para instalar Yonote Document Interaction Server para Claude Desktop automáticamente a través de Smithery :

Instalación manual

1. Clonar el repositorio:

   git clone <your-repo-url> cd yonote-mcp

2. Instalar dependencias usando uv:

   uv pip install -r requirements.txt # or, using pyproject.toml: uv pip install .

3. Configurar variables de entorno:

   Cree un archivo .env en la raíz del proyecto con el siguiente contenido:

   API_TOKEN=your_yonote_api_token API_BASE_URL=https://app.yonote.ru/api # Optional, defaults to this value

Uso

Ejecute el servidor MCP:

El servidor expone las siguientes herramientas:

• documents_list : obtiene una lista de documentos (con límite, desplazamiento y collectionId opcionales)

• documents_info : Obtener información sobre un documento por ID

• collections_list : obtiene una lista de colecciones (con límite y desplazamiento opcionales)

Estructura del proyecto

• main.py — Código del servidor principal y definiciones de herramientas

• pyproject.toml — Metadatos y dependencias del proyecto

Licencia

MIT (o especifique su licencia)

Ejemplo de configuración del cursor

Para utilizar este servidor MCP con Cursor, agregue lo siguiente a su archivo de configuración ~/.cursor/mcp.json :

Reemplace /path/to/yonote-mcp con la ruta real al directorio de su proyecto.