Not 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. 使用您的 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

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

资源

服务器公开以下资源：

工具

该服务器提供以下工具：

提示

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

示例查询

一旦连接到 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 桌面日志：在 Claude 日志目录中查找与 MCP 相关的日志

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