DevLog MCP

Es un servidor MCP stdio que publica en una base de datos existente de Notion Blog las bitácoras de desarrollo escritas por agentes de codificación de IA como Codex y Claude Code. El agente se encarga de la retrospectiva y de redactar el contenido; este servidor solo se encarga de la validación de entradas y del guardado en Notion.

Requisitos

• Node.js 20 o superior

• Base de datos existente de Notion Blog

• Integración de Notion conectada a la base de datos

Related MCP server: Notion MCP Server

Instalación y compilación

npm install
npm test
npm run build

Para ejecutar directamente durante el desarrollo, establece las variables de entorno en la shell actual. Este proyecto no lee automáticamente el archivo .env.

export NOTION_TOKEN="secret_..."
export NOTION_DATABASE_ID="..."
npm run dev

Debido a que el servidor stdio se comunica con el cliente MCP mediante JSON-RPC, no se muestra ningún texto informativo típico al ejecutarlo en la terminal.

Configuración de Notion

1. Crea una integración interna desde la pantalla de Integrations de Notion.

2. Usa el token de integración como NOTION_TOKEN.

3. Agrega esa integración desde el menú de conexiones de la base de datos del blog existente.

4. Localiza el ID de la base de datos en la URL de la base de datos y úsalo como NOTION_DATABASE_ID.

Los nombres y tipos de las propiedades de la base de datos deben ser los siguientes.

Si los nombres proporcionados no existen en las opciones Select, Multi-select y Status de la base de datos existente, la creación de opciones puede verse restringida según los permisos y la configuración de Notion.

Herramientas MCP

El servidor proporciona una única herramienta: publish_dev_log.

type PublishDevLogInput = {
  title: string;
  category?: string;
  tags?: string[];
  publishedAt?: string;
  status?: "published" | "draft";
  content: string;
};

El Markdown admitido en el cuerpo es: títulos de nivel 1 a 3, párrafos, listas ordenadas y no ordenadas, bloques de código delimitados y líneas divisorias.

A continuación se muestra un ejemplo de entrada de invocación.

{
  "title": "DevLog MCP 첫 구현",
  "tags": ["MCP", "Notion", "TypeScript"],
  "content": "# 오늘의 작업\nNotion 발행 도구를 구현했다.\n\n## 결정\n- MCP는 저장만 담당한다.\n- 회고 작성은 코딩 에이전트가 담당한다."
}

Conexión con Codex

Primero, registra el resultado de la compilación usando una ruta absoluta.

codex mcp add devlog-mcp \
  --env NOTION_TOKEN=secret_... \
  --env NOTION_DATABASE_ID=... \
  -- node /Users/oddd/workspace/notion/devlog-mcp/dist/index.js

Verifica el estado del registro con el siguiente comando.

codex mcp list

Conexión con Claude Code

Regístralo como servidor MCP de ámbito de proyecto.

claude mcp add -s project devlog-mcp \
  -e NOTION_TOKEN=secret_... \
  -e NOTION_DATABASE_ID=... \
  -- node /Users/oddd/workspace/notion/devlog-mcp/dist/index.js

Verifica el estado del registro con el siguiente comando.

claude mcp list

Después de la conexión, puedes pedirle al agente: 오늘 개발한 내용을 일지로 정리하고 publish_dev_log로 발행해줘.

devlog-mcp