DevLog MCP

Dies ist ein stdio-MCP-Server, der von KI-Codierungsagenten wie Codex und Claude Code erstellte Entwicklungstagebücher in einer bestehenden Notion Blog-Datenbank veröffentlicht. Der Agent ist für die Reflexion und das Verfassen des Inhalts verantwortlich, während dieser Server nur die Eingabevalidierung und die Notion-Speicherung übernimmt.

Anforderungen

• Node.js 20 oder höher

• Bestehende Notion Blog-Datenbank

• Mit der Datenbank verbundene Notion-Integration

Related MCP server: Notion MCP Server

Installation und Build

npm install
npm test
npm run build

Wenn Sie während der Entwicklung direkt ausführen, setzen Sie die Umgebungsvariablen in der aktuellen Shell. Dieses Projekt liest .env-Dateien nicht automatisch.

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

Der stdio-Server kommuniziert über JSON-RPC mit dem MCP-Client, daher werden bei der Ausführung im Terminal keine allgemeinen Hinweise ausgegeben.

Notion-Einrichtung

1. Erstellen Sie im Bereich „Integrationen“ von Notion eine interne Integration.

2. Verwenden Sie das Integrationstoken als NOTION_TOKEN.

3. Fügen Sie diese Integration im Verbindungsmenü Ihrer bestehenden Blog-Datenbank hinzu.

4. Suchen Sie die Datenbank-ID in der Datenbank-URL und verwenden Sie sie als NOTION_DATABASE_ID.

Die Eigenschaftsnamen und -typen der Datenbank müssen wie folgt sein.

Wenn die übergebenen Namen in den Optionen für Auswahl, Mehrfachauswahl und Status der bestehenden Datenbank nicht vorhanden sind, kann die Erstellung von Optionen je nach Notion-Berechtigungen und -Einstellungen eingeschränkt sein.

MCP-Tool

Der Server stellt ein einziges Tool namens publish_dev_log bereit.

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

Das im Textkörper unterstützte Markdown umfasst Überschriften der Stufen 1–3, Absätze, geordnete/ungeordnete Listen, Codeblöcke mit Begrenzung und Trennlinien.

Ein Beispiel für einen Aufrufeingabe ist wie folgt.

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

Codex-Verbindung

Registrieren Sie zunächst das Build-Ergebnis basierend auf einem absoluten Pfad.

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

Überprüfen Sie den Registrierungsstatus mit dem folgenden Befehl.

codex mcp list

Claude Code-Verbindung

Registrieren Sie es als MCP-Server auf Projektebene.

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

Überprüfen Sie den Registrierungsstatus mit dem folgenden Befehl.

claude mcp list

Nach der Verbindung können Sie den Agenten bitten: „Fasse die heutigen Entwicklungsinhalte in einem Tagebuch zusammen und veröffentliche sie mit publish_dev_log.“

devlog-mcp