Not MCP 服务器
用于与 Notion 工作区集成的模型上下文协议 (MCP) 服务器。该服务器为 AI 模型提供了访问、查询和修改 Notion 内容的标准化接口。
先决条件
Node.js(v16 或更高版本)
Notion API 密钥(来自您的Notion 集成)
具有适当权限的连接 Notion 工作区
Related MCP server: Notion MCP Server
安装
克隆此存储库:
git clone https://github.com/yourusername/notion-mcp-server.git cd notion-mcp-server安装依赖项:
npm install使用您的 Notion API 密钥在根目录中创建一个
.env文件:# Required NOTION_API_KEY=your_notion_api_key_here # Optional settings DEBUG=false REQUIRE_CONFIRMATION_FOR_CREATE=true REQUIRE_CONFIRMATION_FOR_UPDATE=true REQUIRE_CONFIRMATION_FOR_DELETE=true UPDATE_POLLING_INTERVAL=60000 MAX_BLOCK_DEPTH=3 BACKUP_DIR=./backups BACKUP_RETENTION_DAYS=30 MAX_BACKUPS_PER_PAGE=5构建项目:
npm run build启动服务器:
npm start
与 Claude for Desktop 一起使用
要将此 Notion MCP 服务器与 Claude for Desktop 一起使用:
确保 Claude for Desktop 已安装并更新至最新版本
打开Claude for Desktop的配置文件:
在 macOS 上:
~/Library/Application Support/Claude/claude_desktop_config.json在 Windows 上:
%APPDATA%\Claude\claude_desktop_config.json
添加服务器配置:
{ "mcpServers": { "notion": { "command": "node", "args": ["/path/to/notion-mcp-server/build/index.js"], "env": { "NOTION_API_KEY": "your_notion_api_key_here" } } } }保存文件并重新启动 Claude for Desktop
资源
服务器公开以下资源:
资源 URI | 描述 |
| 列出工作区中的所有数据库 |
| 检索特定数据库的架构 |
| 从特定数据库中检索所有页面/项目 |
| 检索特定页面的内容 |
| 检索工作区中最近的更新和更改 |
工具
该服务器提供以下工具:
提示
服务器包括以下预配置的提示:
提示名称 | 描述 |
| 获取即将到来的截止日期列表 |
| 总结项目状态 |
| 获取今天的任务列表 |
示例查询
一旦连接到 Claude,您就可以询问有关 Notion 工作区的自然语言问题:
“今天我的工作区中有哪些任务需要完成?”
“显示 X 项目的状态”
“在我的‘想法’数据库中创建一个新页面,标题为‘新功能概念’”
“将任务 Y 的状态更新为‘已完成’”
“过去 24 小时内我的工作区发生了哪些变化?”
“总结下周的截止日期”
“显示页面 abc123 的所有备份”
“从备份文件page_abc123_2023-01-01.json恢复页面abc123”
扩展服务器
要添加新功能:
添加资源:扩展
index.ts中的资源处理程序添加工具:在
index.ts中创建新的工具定义添加提示:在
index.ts中定义新的提示模板增强 API 集成:在
notion-api.ts中添加新的 API 函数
日志
检查服务器日志以获取详细的错误信息:
Claude 桌面日志:在 Claude 日志目录中查找与 MCP 相关的日志
服务器输出:检查服务器日志的标准输出和错误流