Yonote MCP Server

Prototipo de servidor Yonote MCP

Este es un proyecto MVP de un servidor MCP (Plataforma Multicanal) 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

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

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.