mcp notion

Servidor MCP de noción: notion-texonom

Noción basada en Markdown navegando por MCP con una sola variable ROOT_PAGE , eliminando la necesidad de un token.

• Las páginas de noción se convierten en notas de mimetipo text/markdown .
• Busque y recupere páginas relevantes basadas en la distancia de los gráficos, considerando las relaciones entre padres y referencia.

Un servidor de protocolo de contexto modelo (MCP) para administrar e interactuar con notas basadas en la noción. Este servidor basado en TypeScript demuestra conceptos MCP mediante la integración de recursos, herramientas y solicitaciones que interactúen con las páginas de noción de manera eficiente.

Características

Recursos

• Notas de acceso : Lista y recupere las páginas de noción como note:// Uris con babosas de UUID.
• Metadatos : cada recurso incluye un título, descripción y contenido en formato de Markdown.
• Tipos de MIME : se puede acceder al contenido en formato text/markdown .

Herramientas

• Notas de búsqueda : use la herramienta search_notes para buscar páginas de noción usando una cadena de consulta.
  • Entrada: consulta texto para filtrar páginas relevantes.
  • Salida: Contenido de Markdown de las notas coincidentes.

Indicaciones

• Resumir notas : Genere resúmenes para páginas de nociones individuales.
  • Indicaciones disponibles:
    • summarize_note : resumir una nota específica de URI.
    • suggest_refactor : proponer mejoras estructurales.
    • suggest_fix : identifique las soluciones potenciales para el contenido de notas.
    • suggest_enhance : recomiende mejoras para mejorar la nota.
  • Entrada: Página de noción URI.
  • Salida: mensajes estructurados para resumen y mejora.

Desarrollo

Configuración

Instalar dependencias:

pnpm install

Construye el proyecto:

pnpm build

Para el desarrollo con auto-reBuild:

pnpm watch

Configuración

Para configurar el servidor con noción:

• Establecer variables de entorno:
  • ROOT_PAGE : el ID de página raíz de su espacio de trabajo de noción.

Instalación para Claude Desktop

Para usar este servidor con Claude Desktop, agregue 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 la resolución de problemas y la depuración del servidor MCP, use el inspector MCP. Para comenzar el inspector, ejecute:

pnpm inspector

El inspector proporciona una interfaz basada en el navegador para inspeccionar la comunicación del servidor basada en STDIO.

Tecnologías clave

• Integración de la noción: alimentado por @texonom/nclient y @texonom/cli.
• MCP SDK: implementos @modelcontextprotocol/sdk para operaciones del servidor.