基本能力
产品定位
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 服务器通信。
使用教程
使用依赖
安装项目依赖:
bash
pnpm install
安装教程
构建项目:
bash
pnpm build
开发模式下自动重建:
bash
pnpm watch
调试方式
启动 MCP 检查器:
bash
pnpm inspector
远程部署
使用 SSEServerTransport
进行远程通信:
bash
npx -y supergateway --port 8000 --stdio "npx -y @modelcontextprotocol/server-filesystem /some/folder"
替换 /some/folder
为你的文件夹路径。