Notion MCP 服务器

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

先决条件

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

安装

克隆此仓库：

git clone https://github.com/yourusername/notion-mcp-server.git cd notion-mcp-server
安装依赖项：

npm install
在根目录下创建一个 .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
构建项目：

npm run build
启动服务器：

npm start

与 Claude for Desktop 一起使用

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

确保已安装并更新到最新版本的 Claude for Desktop
打开 Claude for Desktop 的配置文件：
- 在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
- 在 Windows 上：%APPDATA%Claudeclaude_desktop_config.json
添加服务器配置：

json { "mcpServers": { "notion": { "command": "node", "args": ["/path/to/notion-mcp-server/build/index.js"], "env": { "NOTION_API_KEY": "your_notion_api_key_here" } } } }
保存文件并重启 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 工作区的自然语言问题：

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

扩展服务器

要添加新功能：

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

日志

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

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

服务配置

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

来源

来源：github
链接：https://github.com/ghubnerr/notion-mcp

ghubnerr