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桌面版配合使用

要将此Notion MCP服务器与Claude桌面版配合使用:

1. 确保已安装最新版Claude桌面版

2. 打开Claude桌面版的配置文件:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_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桌面版

资源

服务器暴露以下资源:

工具

服务器提供以下工具:

预设提示

服务器包含这些预配置提示:

示例查询

连接到Claude后，您可以对Notion工作空间提出自然语言问题:

1. "我的工作空间中今天有哪些任务到期?"
2. "显示项目X的状态"
3. "在我的'Ideas'数据库中创建一个标题为'New Feature Concept'的新页面"
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桌面版日志: 在Claude日志目录中查找MCP相关日志
• 服务器输出: 检查标准输出和错误流中的服务器日志