Notion MCP Server 使用说明

项目简介

Notion MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它充当 LLM (如 Claude) 与 Notion 知识库之间的桥梁。通过提供一系列预定义的工具，该服务器允许 LLM 客户端以标准化的方式查询和操作 Notion 页面和数据库，从而实现更智能化的知识库交互和自动化任务。

主要功能点

连接 Notion 知识库：允许 LLM 客户端安全访问和操作您的 Notion 页面和数据库。
提供丰富的工具集：内置多种工具，包括：
- 页面操作：检索页面内容、更新页面属性。
- 块操作：追加块子元素、检索块信息、检索块子元素、删除块。
- 数据库操作：创建数据库、查询数据库、检索数据库信息、更新数据库、创建数据库条目。
易于安装和配置：使用 npm 进行包管理，配置简单，快速启动服务。
基于标准 MCP 协议：采用通用的 MCP 协议，易于与各种支持 MCP 的 LLM 客户端集成。

安装步骤

克隆仓库到本地

git clone https://github.com/MCP-Mirror/arre-ankit_notion-mcp-server.git
cd arre-ankit_notion-mcp-server

安装依赖 确保您已安装 Node.js 和 npm。在项目根目录下运行：
```
npm install
```
构建项目
```
npm run build
```
配置 Notion Integration
- 访问 Notion Integrations 并创建一个新的 integration。
- 将 integration 命名为 “MCP Server” 或其他易于识别的名称。
- 重要：配置 integration 的权限，至少需要为 “Pages” 设置 读取 (Read) 和 写入 (Write) 权限，以便服务器可以访问和修改 Notion 内容。
- 复制生成的 Integration Token，这个 Token 将用于服务器连接到您的 Notion 工作区。

服务器配置

MCP 服务器需要配置在 MCP 客户端中，以便客户端能够连接和使用服务器提供的工具。以下是 'claude_desktop_config.json' 的配置示例，适用于 Claude 等支持 MCP 协议的客户端。

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "node",
      "args": [
        "dist/index.js"
      ],
      "env": {
        "NOTION_API_TOKEN": "YOUR_NOTION_INTEGRATION_TOKEN"
      }
    }
  }
}

配置参数说明：

'"notion-mcp-server"': 服务器名称，客户端用于识别和引用该服务器。可以自定义。
'"command"': 启动服务器的命令，这里使用 'node' 运行 JavaScript 文件。
'"args"': 命令参数，指定服务器入口文件路径。请确保 '"dist/index.js"' 路径是相对于 'claude_desktop_config.json' 文件位置的正确路径。如果您的 'claude_desktop_config.json' 文件与 'arre-ankit_notion-mcp-server' 项目根目录不在同一位置，您可能需要根据实际情况调整路径。
'"env"': 环境变量配置。
- '"NOTION_API_TOKEN"': 必须替换为 您在 Notion Integration 步骤中复制的 Integration Token。这是服务器连接 Notion API 的凭证。

请注意：

'claude_desktop_config.json' 文件通常位于 Claude 客户端的配置目录下。具体位置请参考 Claude 客户端的文档。
请将 '"YOUR_NOTION_INTEGRATION_TOKEN"' 替换为您真实的 Notion Integration Token。

基本使用方法

启动 MCP 客户端 (例如 Claude)。

在 LLM 客户端的 Prompt 中，您可以指示 LLM 使用 Notion 工具来完成特定任务。例如：

Prompt 示例：

请在我的 Notion 页面 https://www.notion.so/xxxxxxxxxxxxxxxxxxxxxxxxxxx 中创建一个新的数据库条目，标题为 "待办事项"，内容为 "购买牛奶"。

或

查询 Notion 页面 https://www.notion.so/yyyyyyyyyyyyyyyyyyyyyyyyyy 的内容。

LLM 客户端 (如 Claude) 将会解析您的 Prompt，识别出需要使用 Notion 工具的意图，并调用 Notion MCP Server 提供的相应工具来执行操作。
Notion MCP Server 接收到客户端的工具调用请求后，会根据请求参数，调用 Notion API 执行相应的操作，并将结果返回给 LLM 客户端。
您可以在您的 Notion 工作区中 看到 LLM 客户端通过 MCP Server 执行的操作结果，例如，新的数据库条目会被添加到指定的 Notion 页面中。

通过以上步骤，您就可以利用 Notion MCP Server 将 LLM 客户端与您的 Notion 知识库连接起来，实现更智能的工作流程。

关键词