Notion集成服务器

MCP服务器概念

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

先决条件

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

安装

1. 克隆此存储库：

   复制

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

2. 安装依赖项：

   复制

   npm install
   

3. 创建一个 .env 使用您的Notion API密钥在根目录中的文件：

   复制

   # 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
   

4. 构建项目：

   复制

   npm run build
   

5. 启动服务器：

   复制

   npm start
   

使用Claude for Desktop

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

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

2. 打开Claude以获取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集成：在中添加新的API函数 notion-api.ts

日志

检查服务器日志以获取详细的错误信息：

• Claude用于桌面日志：在Claude logs目录中查找与MCP相关的日志
• 服务器输出：检查服务器日志的标准输出和错误流