DevLog MCP

这是一个 stdio MCP 服务器，用于将 Codex、Claude Code 等 AI 编码代理编写的开发日志发布到现有的 Notion Blog 数据库中。代理负责回顾和正文撰写，而此服务器仅负责输入验证和 Notion 存储。

要求

• Node.js 20 或更高版本

• 现有的 Notion Blog 数据库

• 连接到数据库的 Notion 集成

Related MCP server: Notion MCP Server

安装与构建

npm install
npm test
npm run build

在开发过程中直接运行时，需在当前 shell 中设置环境变量。此项目不会自动读取 .env 文件。

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

由于 stdio 服务器通过 JSON-RPC 与 MCP 客户端通信，因此在终端中运行时不会输出常规的提示信息。

Notion 设置

1. 在 Notion 的 Integrations 页面中创建一个 Internal Integration。

2. 将 Integration token 用作 NOTION_TOKEN。

3. 在现有 Blog 数据库的连接菜单中添加该 Integration。

4. 从数据库 URL 中找到 Database ID，并将其用作 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