Simple Notion MCP Server

Simple Notion MCP Server

概述

本项目实现了一个 Model Context Protocol（MCP）服务，用作 AI 助手与 Notion API 之间的桥梁。与返回大型 JSON 数据块的官方 Notion MCP 服务不同，本服务会将 Notion 页面渲染为 Markdown，让大模型更高效地处理和理解页面内容。

功能

• Markdown 渲染：将 Notion 页面转换为简洁易读的 Markdown 格式
• 富文本支持：保留粗体、斜体、删除线和代码元素的格式

设置

1. 创建一个 Notion 集成，并从 https://www.notion.so/my-integrations 获取 API 令牌
2. 将令牌设置为环境变量：

export NOTION_TOKEN=your-notion-api-token

或者，你也可以在项目中创建一个 .env 文件：

NOTION_TOKEN=your-notion-api-token

3. 确保将你要访问的 Notion 页面共享给该集成

用法

在 VS Code 中使用

将以下内容添加到你的设置 JSON 文件中：

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "notion_token",
        "description": "Notion API Token",
        "password": true
      }
    ],
    "servers": {
      "notion": {
        "command": "npx",
        "args": [
          "-y",
          "@larryhudson/simple-notion-mcp-server"
        ],
        "env": {
          "NOTION_TOKEN": "${input:notion_token}"
        }
      }
    }
  }
}

在 Claude 或其他兼容 MCP 的应用中使用

将以下内容添加到你的 MCP 配置 JSON 文件中：

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@larryhudson/simple-notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "<YOUR_NOTION_API_TOKEN>"
      }
    }
  }
}

可用工具

get_page

根据 ID 获取 Notion 页面，并将其渲染为 Markdown。

参数：

• page_id：要获取的 Notion 页面的 ID

示例：

{
  "page_id": "83c75a5b7a324be29d454536f2345678"
}

工作原理

服务会通过以下步骤处理 Notion 页面：

1. 使用 Notion API 获取页面元数据
2. 获取页面中的所有块（递归获取子块）
3. 将块格式化为 Markdown，同时保留结构和格式
4. 返回简洁的页面 Markdown 表示

技术细节

构建所用技术：

• Model Context Protocol（MCP）：用于让 AI 助手与外部工具交互的框架
• Notion API Client：用于与 Notion 通信的官方客户端
• TypeScript：用于确保类型安全并改善开发者体验

开发

你可以使用 Model Context Protocol 检查器试用此服务：

npx @modelcontextprotocol/inspector npx tsx src/index.ts

限制与未来改进

• 目前仅支持获取页面（不支持更新或创建页面）
• 图片处理可在未来版本中改进（例如，将图片渲染为 base64 图片块）

许可证

MIT