Notion MCP Server 使用说明

项目简介

Notion MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它允许AI助手通过标准化的MCP协议与Notion进行交互。借助此服务器，AI助手可以读取、创建、更新和删除 Notion 页面、数据库和块，从而扩展AI在知识管理和生产力工具方面的能力。

主要功能点

Notion 数据交互: 支持对 Notion 页面、数据库和块进行全面的CRUD操作。
MCP 协议兼容: 遵循 MCP 协议标准，可与任何 MCP 客户端集成，如 Cursor, Claude Desktop, Cline, 和 Zed。
数据检索: 允许AI助手从 Notion 页面、块和数据库中检索信息。
内容创作与编辑: 支持创建和更新 Notion 页面和块内容。
数据库操作: 提供创建、查询和更新 Notion 数据库的功能。
批量操作: 支持批量处理多个 Notion 对象的更新和删除，提高效率。
页面归档与恢复: 允许AI助手归档和恢复 Notion 页面。
内容搜索: 支持按标题搜索 Notion 页面和数据库。

安装步骤

获取 Notion API 密钥:
- 访问 Notion Developers 创建一个新的集成。
- 复制您的 API 密钥。
关联 Notion 集成:
- 在 Notion 中选择一个页面或创建一个新页面。
- 点击页面右上角的 "..." 菜单。
- 选择 "连接" (Connections)。
- 在列表中找到您的集成并启用。

安装 Notion MCP Server:

确保已安装 Node.js 和 npm。

克隆仓库到本地：

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

安装依赖：
```
npm install
```
创建 '.env' 文件，并配置 Notion API 密钥和页面 ID：
```
NOTION_TOKEN=YOUR_NOTION_API_KEY
NOTION_PAGE_ID=YOUR_NOTION_PAGE_ID
```
请将 'YOUR_NOTION_API_KEY' 替换为您的 Notion API 密钥，'YOUR_NOTION_PAGE_ID' 替换为您希望作为根页面的 Notion 页面 ID。

构建项目:
```
npm run build
```
启动服务器:
```
npm run inspector
```
或者直接使用 'npx notion-mcp-server' 命令启动。

服务器配置

要将 Notion MCP Server 集成到 MCP 客户端，您需要配置服务器的启动命令。以下是针对不同 MCP 客户端的配置示例 (JSON 格式)：

通用配置 (适用于 Cursor, Claude Desktop, Cline, Zed 等 MCP 客户端)

{
  "mcpServers": {
    "notion-mcp-server": {  // 服务器名称，客户端内唯一标识
      "command": "npx",     // 启动命令，通常为 npx 或 node
      "args": ["-y", "notion-mcp-server"], // 命令参数，指定运行 notion-mcp-server
      "env": {               // 环境变量配置
        "NOTION_TOKEN": "YOUR_NOTION_API_KEY", // 您的 Notion API 密钥
        "NOTION_PAGE_ID": "YOUR_NOTION_PAGE_ID" // 您的 Notion 根页面 ID
      }
    }
  }
}

请将 'YOUR_NOTION_API_KEY' 和 'YOUR_NOTION_PAGE_ID' 替换为您的实际值。

Cursor 客户端配置示例 ('.cursor/mcp.json')

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "env NOTION_TOKEN=YOUR_KEY NOTION_PAGE_ID=YOUR_PAGE_ID npx",
      "args": ["-y", "notion-mcp-server"]
    }
  }
}

替换 'YOUR_KEY' 和 'YOUR_PAGE_ID' 为您的实际值。

Claude Desktop 客户端配置示例 ('mcp.json')

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": ["-y", "notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "YOUR_KEY",
        "NOTION_PAGE_ID": "YOUR_PAGE_ID"
      }
    }
  }
}