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

Related MCP server: Notion MCP Server

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)