Explore todo su espacio de trabajo de Notion, no solo una base de datos

Notion basado en Markdown que navega en MCP con solo una variable ROOT_PAGE , eliminando la necesidad de un token.

• Servidor MCP de Notion: notion-texonom

• Las páginas de Notion se convierten en notas MIMEType text/markdown .

• Busque y recupere páginas relevantes según la distancia del gráfico, considerando las 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, muestra los conceptos de MCP integrando recursos, herramientas y sugerencias para interactuar eficientemente con las páginas de Notion.

Características

Recursos

• Notas de acceso : enumera y recupera páginas de Notion como URI note:// con slugs UUID.

• Metadatos : cada recurso incluye un título, una descripción y contenido en formato Markdown.

• Tipos MIME : el contenido es accesible en formato text/markdown .

Herramientas

• Notas de búsqueda : utilice la herramienta search_notes para buscar páginas de Notion utilizando una cadena de consulta.

  • Entrada: Texto de consulta para filtrar páginas relevantes.

  • Salida: Contenido Markdown de las notas coincidentes.

Indicaciones

• Resumir notas : genere resúmenes para páginas de Notion individuales.

  • Indicaciones disponibles:

    • summarize_note : Resume una nota específica por URI.

    • suggest_refactor : Proponer mejoras estructurales.

    • suggest_fix : Identifica posibles soluciones para el contenido de las notas.

    • suggest_enhance : Recomienda mejoras para mejorar la nota.

  • Entrada: URI de la página de noción.

  • Salida: Mensajes estructurados para resumir y mejorar.

Related MCP server: github-manager MCP Server

Desarrollo

Configuración

Instalar dependencias:

pnpm install

Construir 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 su espacio de trabajo de Notion.

Instalación para Claude Desktop

Para utilizar este servidor con Claude Desktop, agregue la configuración:

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

• Ventanas: %APPDATA%/Claude/claude_desktop_config.json

Ejemplo de configuración:

{
  "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, utilice el Inspector de MCP. Para iniciarlo, ejecute:

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 de Notion: Desarrollado por @texonom/nclient y @texonom/cli.

• SDK de MCP: implementa @modelcontextprotocol/sdk para operaciones del servidor.

Implementación remota

El servidor ahora utiliza SSEServerTransport para la comunicación remota, lo que permite el uso compartido del servidor. Asegúrese de que las dependencias necesarias estén instaladas y de que el servidor esté configurado correctamente para la implementación remota.

Instrucciones de uso

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

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

Asegúrese de reemplazar /some/folder con la ruta apropiada a su carpeta.