Notion Knowledge Base MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Used for loading environment variables from a .env file, specifically to securely store and access the Dify API key needed for the Notion knowledge base connection.

  • Provides access to a Notion knowledge base, allowing users to query their Notion content directly, receive detailed answers with references to specific Notion pages, and view related page IDs.

Base de conocimientos de Notion Servidor MCP

Un servidor MCP que proporciona acceso a una base de conocimiento de Notion a través de la extensión Cline VSCode.

Características

  • Consulta tu base de conocimientos de Notion directamente desde Cline
  • Obtenga respuestas detalladas con referencias a las páginas de Notion
  • Creado con FastMCP para un rendimiento confiable
  • Manejo y registro de errores integral

Prerrequisitos

  • Python 3.10 o superior
  • administrador de paquetes uv
  • Extensión Cline VSCode
  • Una clave API de Dify para acceder a la base de conocimientos de Notion

Instalación

  1. Clonar este repositorio:
    git clone https://github.com/yourusername/notion-mcp-server.git cd notion-mcp-server
  2. Crea un archivo .env con tu clave API de Dify:
    echo "DIFY_API_BACKEND_KEY=your-api-key-here" > .env
  3. Instalar el servidor en Cline:
    fastmcp install notion_mcp_server.py
    Esto automáticamente:
    • Instale todas las dependencias necesarias usando uv
    • Configurar el servidor en la configuración de Cline
    • Hacer que el servidor esté disponible para su uso con Cline

Uso

Una vez instalado, puede usar el servidor en Cline preguntando sobre su base de conocimientos de Notion. Por ejemplo:

Tell me about internal tooling

El servidor responderá con información relevante de su base de conocimiento de Notion, que incluye:

  • Respuestas detalladas
  • Enlaces a páginas relevantes de Notion
  • Identificadores de página para referencia

Configuración

El servidor se configura automáticamente durante la instalación, pero puedes actualizar manualmente la configuración en el archivo de configuración de Cline si es necesario:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Ventanas: %APPDATA%\Claude\claude_desktop_config.json

Ejemplo de configuración:

{ "mcpServers": { "notion-kb": { "command": "uv", "args": [ "run", "--with", "fastmcp", "--with", "python-dotenv", "--with", "requests", "fastmcp", "run", "/absolute/path/to/notion_mcp_server.py" ], "env": { "DIFY_API_BACKEND_KEY": "your-api-key" } } } }

Desarrollo

Para desarrollo y pruebas:

  1. Instalar dependencias:
    pip install -r requirements.txt
  2. Ejecute el servidor de desarrollo:
    fastmcp dev notion_mcp_server.py

Esto iniciará la interfaz de MCP Inspector para probar el servidor.

Solución de problemas

  1. El servidor no se conecta
    • Verifique su clave API en el archivo .env
    • Asegúrese de que la ruta del servidor en la configuración de Cline sea absoluta
    • Comprueba que uv esté instalado y en tu PATH
  2. Problemas de dependencias
    • Intente reinstalar con fastmcp install notion_mcp_server.py --force
    • Verifique que el UV esté instalado correctamente
  3. El servidor se cuelga
    • Asegúrese de estar utilizando el comando uv run como se especifica en la configuración
    • Verifique los registros del servidor para detectar errores

Contribuyendo

Consulte mcp_instructions.md para obtener información detallada sobre la implementación y la arquitectura del servidor.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

-
security - not tested
F
license - not found
-
quality - not tested

Un servidor MCP que se conecta a su base de conocimiento de Notion, lo que le permite consultar y recuperar información directamente desde VSCode utilizando la extensión Cline.

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Configuration
            1. Development
              1. Troubleshooting
                1. Contributing
                  1. License
                    ID: xvq6i7dram