Notion

Navega por todo tu espacio de trabajo de Notion, no solo una base de datos

MCP de navegación de Notion basado en Markdown con una sola variable ROOT_PAGE, eliminando la necesidad de un token.

• Servidor MCP de Notion: notion-texonom
• Las páginas de Notion se convierten en notas de tipo mime text/markdown.
• Busca y recupera páginas relevantes según la distancia en el grafo, considerando relaciones padre-hijo y de referencia.

Un servidor de Protocolo de Contexto de Modelo (MCP) para gestionar e interactuar con notas basadas en Notion. Este servidor basado en TypeScript demuestra conceptos de MCP integrando recursos, herramientas y avisos para interactuar con páginas de Notion de manera eficiente.

Características

Recursos

• Acceso a Notas: Lista y recupera páginas de Notion como URIs note:// con slugs UUID.
• Metadatos: Cada recurso incluye un título, descripción y contenido en formato Markdown.
• Tipos Mime: El contenido es accesible en formato text/markdown.

Herramientas

• Buscar Notas: Usa la herramienta search_notes para buscar páginas de Notion usando una cadena de consulta.
  • Entrada: Texto de consulta para filtrar páginas relevantes.
  • Salida: Contenido Markdown de las notas coincidentes.

Indicaciones

• Resumir Notas: Genera resúmenes para páginas individuales de Notion.
  • Indicaciones disponibles:
    • summarize_note: Resumir una nota específica por URI.
    • suggest_refactor: Proponer mejoras estructurales.
    • suggest_fix: Identificar posibles correcciones para el contenido de la nota.
    • suggest_enhance: Recomendar mejoras para mejorar la nota.
  • Entrada: URI de la página de Notion.
  • Salida: Mensajes estructurados para resumen y mejora.

Desarrollo

Preparación

Instalar dependencias:

pnpm install

Compilar el proyecto:

pnpm build

Para desarrollo con reconstrucción automática:

pnpm watch

Configuración

Para configurar el servidor con Notion:

• Establecer variables de entorno:
  • ROOT_PAGE: El ID de la página raíz de tu espacio de trabajo de Notion.

Instalación para Claude Desktop

Para usar este servidor con Claude Desktop, añade la configuración:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuración de ejemplo:

{
  "mcpServers": {
    "notion-texonom": {
      "command": "node",
      "args": [
        "/path/to/mcp/build/index.js"
      ],
      "env": {
        "ROOT_PAGE": "$SOME_UUID"
      }
    }
  }
}

Depuración

Para solucionar problemas y depurar el servidor MCP, usa el Inspector MCP. Para iniciar el Inspector, ejecuta:

pnpm inspector

El Inspector proporciona una interfaz basada en navegador para inspeccionar la comunicación del servidor basada en stdio.

Tecnologías Clave

• Integración con Notion: Impulsada por @texonom/nclient y @texonom/cli.
• SDK de MCP: Implementa @modelcontextprotocol/sdk para operaciones del servidor.

Despliegue Remoto

El servidor ahora usa SSEServerTransport para comunicación remota, permitiendo el uso compartido del servidor. Asegúrate de que las dependencias necesarias estén instaladas y que el servidor esté configurado correctamente para el despliegue remoto.

Instrucciones de Uso

Para ejecutar el servidor con SSEServerTransport, usa el siguiente comando:

npx -y supergateway --port 8000 --stdio "npx -y @modelcontextprotocol/server-filesystem /some/folder"

Asegúrate de reemplazar /some/folder con la ruta adecuada a tu carpeta.