makenotion/notion-mcp-server

解决的问题

本项目为 AI Agent 提供了一种直接与 Notion 工作区交互的方式。它弥合了 LLM 驱动的客户端（如 Claude Desktop、Cursor 或 Zed）与 Notion API 之间的鸿沟，允许 AI 使用标准化协议读取、搜索和编辑 Notion 页面及数据库。

工作原理

它实现了一个封装了 Notion API 的 Model Context Protocol (MCP) 服务器。该服务器公开了一套 AI Agent 可以发现并调用的工具（目前为 22 个）。它支持两种通信方式：用于本地桌面客户端的标准输入/输出 (STDIO) 以及用于 Web 应用程序的可流式 HTTP 传输。为了针对 AI 进行优化，它包含了专门的工具，将页面内容处理为 Markdown 而非复杂的 JSON 块，从而减少了 Token 的使用。

适用对象

• AI Agent 用户：希望其 AI 能够管理 Notion 笔记和数据库的 MCP 兼容客户端用户。
• 开发者：正在构建需要结构化且高效利用 Token 的方式来集成 Notion 数据的 AI 应用的开发者。

亮点

• 高效利用 Token 的 Markdown：专门用于以 Markdown 格式读取和更新页面内容的工具，以节省 LLM Token。
• 灵活的部署：可以通过 npm、Docker 或作为远程服务器运行。
• 多租户支持：支持 Token 透传，允许单个服务器部署服务于多个 Notion 集成。
• 广泛的客户端兼容性：为 Cursor、Claude Desktop、Zed 和 GitHub Copilot CLI 提供即插即用的配置。