NotionMCP Light

NotionMCP Light es un servidor de Protocolo de contexto de modelo (MCP) que utiliza la API de Notion para sincronizar archivos Markdown con páginas de Notion.

descripción general

El proyecto se desarrolló para abordar las ineficiencias de los servidores oficiales del Protocolo de Contexto de Modelo (MCP) de Notion, que leen y escriben Markdown en bloques y consumen tokens LLM. Proporcionamos un servidor MCP no oficial que le permite sincronizar archivos Markdown con páginas/bases de datos de Notion directamente a través de API sin usar tokens.

función

Markdown → Noción
- Reconocer H1 como título de la página
- Cree contenido Markdown como una página de Notion o una página de base de datos
- Se puede especificar el ID de la base de datos
- Usando la API de Notion directamente (sin tokens)
Noción → Markdown
- Convierte una página determinada o una página de una base de datos al formato Markdown.
- Título de salida como H1
- Convertir la estructura de bloques a Markdown
- Guardar en archivo
Compatibilidad con servidores MCP
- Compatible con el Protocolo de Contexto de Modelo (MCP)
- Proporciona puntos finales que se pueden llamar desde herramientas de IA como Cursor y Cline
- Basado en JSON-RPC sobre stdio

instalar

Instalación de dependencias

# uvがインストールされていない場合は先にインストール
# pip install uv

# 依存関係のインストール
uv sync

Configuración del token de API de Notion

Crea una cuenta en Notion Developers y obtén un token API.
Puede configurarlo en una variable de entorno o crear un archivo .env y configurar el token.

# .envファイルの例
NOTION_TOKEN=your_notion_api_token

Cómo utilizar

Iniciar el servidor MCP

Al utilizar UV (recomendado)

uv run python -m src.main

O, si desea especificar el token directamente:

uv run python -m src.main --token your_notion_api_token

Si usas Python normal

python -m src.main

O, si desea especificar el token directamente:

python -m src.main --token your_notion_api_token

Configuración en Cline/Cursor

Para usar NotionMCP Light con herramientas de IA como Cline/Cursor, agregue las siguientes configuraciones a su archivo mcp_settings.json :

"notion-mcp-light": {
  "command": "uv",
  "args": [
    "run",
    "--directory",
    "/path/to/notion-mcp-light",
    "python",
    "-m",
    "src.main"
  ],
  "env": {
    "NOTION_TOKEN": "your_notion_api_token"
  },
  "disabled": false,
  "alwaysAllow": []
}

Reemplace /path/to/notion-mcp-light con el directorio de instalación de NotionMCP Light.

Cómo utilizar las herramientas MCP

NotionMCP Light ofrece las siguientes herramientas MCP:

subirMarkdown

Sube tu archivo Markdown y créalo como una página Notion.

{
  "jsonrpc": "2.0",
  "method": "uploadMarkdown",
  "params": {
    "filepath": "path/to/markdown.md",
    "database_id": "optional_database_id",
    "page_id": "optional_parent_page_id"
  },
  "id": 1
}

Descargar Markdown

Descargue su página de Notion y guárdela como un archivo Markdown.

{
  "jsonrpc": "2.0",
  "method": "downloadMarkdown",
  "params": {
    "page_id": "notion_page_id",
    "output_path": "path/to/output.md"
  },
  "id": 2
}

licencia

Este proyecto se publica bajo la licencia MIT. Consulte el archivo de LICENCIA para obtener más detalles.