Browse your entire Notion workspace, not just one database
2025.03.19
6
TypeScriptNotion 集成笔记管理Markdown 转换开发效率内容生成
mcp-notion 是一个基于 Markdown 的 Notion 导航 MCP 服务器，允许用户通过单个 `ROOT_PAGE` 变量浏览整个 Notion 工作区，无需令牌。它能够将 Notion 页面转换为 `text/markdown` 格式的笔记，并根据图距离（考虑父子关系和引用关系）搜索和检索相关页面。该服务器使用 TypeScript 开发，集成了资源、工具和提示，以高效地与 Notion 页面交互。
View on GitHub
Overview
基本能力
产品定位
mcp-notion 是一个用于管理和与 Notion 笔记交互的 MCP 服务器，特别适合需要高效浏览和操作 Notion 工作区的用户。
核心功能
- 访问笔记：以
note://URI 形式列出和检索 Notion 页面，包含标题、描述和 Markdown 格式的内容。 - 搜索笔记：使用
search_notes工具通过查询字符串搜索 Notion 页面。 - 笔记摘要与增强：提供多种提示功能，如
summarize_note（摘要笔记）、suggest_refactor（建议重构）、suggest_fix（建议修复）和suggest_enhance（建议增强）。
适用场景
- 需要快速浏览和检索 Notion 工作区内容的用户。
- 需要对 Notion 笔记进行摘要、重构或增强的开发者和内容创作者。
工具列表
- search_notes：通过查询字符串搜索 Notion 页面，返回匹配笔记的 Markdown 内容。
- summarize_note：摘要特定笔记。
- suggest_refactor：建议笔记的结构改进。
- suggest_fix：识别笔记内容的潜在修复点。
- suggest_enhance：推荐增强笔记内容的建议。
常见问题解答
- 如何配置服务器：设置环境变量
ROOT_PAGE为 Notion 工作区的根页面 ID。 - 如何调试：使用
pnpm inspector启动 MCP 检查器，检查 stdio 服务器通信。
使用教程
使用依赖
安装项目依赖：
pnpm install
安装教程
构建项目：
pnpm build
开发模式下自动重建：
pnpm watch
调试方式
启动 MCP 检查器：
pnpm inspector
远程部署
使用 SSEServerTransport 进行远程通信：
npx -y supergateway --port 8000 --stdio "npx -y @modelcontextprotocol/server-filesystem /some/folder"
替换 /some/folder 为你的文件夹路径。