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%\Claude\claude_desktop_config.json

3. 添加服务器配置：

   {
     "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

资源

服务器公开以下资源：

资源 URI	描述
notion://databases	列出工作区中的所有数据库
notion://databases/{databaseId}/schema	检索特定数据库的模式
notion://databases/{databaseId}/content	检索特定数据库中的所有页面/项目
notion://pages/{pageId}	检索特定页面的内容
notion://updates	检索工作区中的最新更新和更改

工具

服务器提供以下工具：

提示词

服务器包含以下预配置的提示词：

提示词名称	描述
upcoming-deadlines	获取即将到来的截止日期列表
project-status	总结项目的状态
daily-tasks	获取今天的任务列表

示例查询

连接到 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 相关的日志
• 服务器输出: 检查标准输出和错误流中的服务器日志