Notion MCP 服务器

一个用于与 Notion 工作区集成的模型上下文协议 (MCP) 服务器。该服务器为 AI 模型提供了访问、查询和修改 Notion 内容的标准接口。

先决条件

• Node.js（v16 或更高版本）
• Notion API 密钥（来自您的 Notion 集成）
• 连接了具有适当权限的 Notion 工作区

安装

1. 克隆此仓库：

   git clone https://github.com/yourusername/notion-mcp-server.git cd notion-mcp-server

2. 安装依赖项：

   npm install

3. 在根目录下创建一个 .env 文件，并填入您的 Notion API 密钥：

   必需

   NOTION_API_KEY=your_notion_api_key_here

   可选设置

   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

4. 构建项目：

   npm run build

5. 启动服务器：

   npm start

与 Claude for Desktop 一起使用

要将此 Notion MCP 服务器与 Claude for Desktop 一起使用：

1. 确保已安装并更新到最新版本的 Claude for Desktop

2. 打开 Claude for Desktop 的配置文件：

   • 在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
   • 在 Windows 上：%APPDATA%Claudeclaude_desktop_config.json

3. 添加服务器配置：

   json { "mcpServers": { "notion": { "command": "node", "args": ["/path/to/notion-mcp-server/build/index.js"], "env": { "NOTION_API_KEY": "your_notion_api_key_here" } } } }

4. 保存文件并重启 Claude for Desktop

资源

服务器公开以下资源：

工具

服务器提供以下工具：

提示

服务器包括这些预配置的提示：

示例查询

连接到 Claude 后，您可以询问有关您的 Notion 工作区的自然语言问题：

1. “我今天的工作区有哪些任务到期？”
2. “显示项目 X 的状态”
3. “在我的‘想法’数据库中创建一个标题为‘新功能概念’的新页面”
4. “将任务 Y 的状态更新为‘已完成’”
5. “我的工作区在过去 24 小时内做了哪些更改？”
6. “总结下周的即将到期的任务”
7. “显示页面 abc123 的所有备份”
8. “从备份文件 page_abc123_2023-01-01.json 中恢复页面 abc123”

扩展服务器

要添加新功能：

1. 添加资源：在 index.ts 中扩展资源处理程序
2. 添加工具：在 index.ts 中创建新的工具定义
3. 添加提示：在 index.ts 中定义新的提示模板
4. 增强 API 集成：在 notion-api.ts 中添加新的 API 函数

日志

检查服务器日志以获取详细的错误信息：- Claude for Desktop 日志：请在 Claude 日志目录中查找与 MCP 相关的日志

• 服务器输出：检查标准输出和错误流以获取服务器日志