DevLog MCP

Это stdio MCP-сервер, который публикует журналы разработки, написанные AI-агентами кодирования, такими как Codex, Claude Code, в существующую базу данных Notion Blog. Агент отвечает за ретроспективу и написание текста, а этот сервер отвечает только за проверку ввода и сохранение в Notion.

Требования

• Node.js 20 или выше

• Существующая база данных Notion Blog

• Notion Integration, подключенная к базе данных

Related MCP server: Notion MCP Server

Установка и сборка

npm install
npm test
npm run build

При непосредственном запуске во время разработки установите переменные окружения в текущей оболочке. Этот проект не читает файл .env автоматически.

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

Поскольку stdio-сервер общается с MCP-клиентом через JSON-RPC, при запуске в терминале не выводится обычное приветственное сообщение.

Настройка Notion

1. Создайте внутреннюю интеграцию на странице Integrations в Notion.

2. Используйте токен интеграции как NOTION_TOKEN.

3. В меню подключений существующей базы данных блога добавьте эту интеграцию.

4. Найдите ID базы данных в URL базы данных и используйте его как NOTION_DATABASE_ID.

Имена и типы свойств базы данных должны быть следующими:

Если переданное имя отсутствует в параметрах Select, Multi-select, Status существующей базы данных, создание параметров может быть ограничено в зависимости от прав и настроек Notion.

Инструменты MCP

Сервер предоставляет один инструмент publish_dev_log.

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

Поддерживаемый Markdown в тексте: заголовки 1–3, абзацы, упорядоченные/неупорядоченные списки, блоки кода с ограждением, разделители.

Пример входных данных для вызова:

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

Подключение Codex

Сначала зарегистрируйте результат сборки, используя абсолютный путь.

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

Проверьте статус регистрации следующей командой:

codex mcp list

Подключение Claude Code

Зарегистрируйте как MCP-сервер в рамках проекта.

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

Проверьте статус регистрации следующей командой:

claude mcp list

После подключения вы можете попросить агента: 오늘 개발한 내용을 일지로 정리하고 publish_dev_log로 발행해줘

devlog-mcp