使用说明

项目简介

Notion MCP Server 是一个基于 Model Context Protocol (MCP) 协议的服务器端实现，它充当 AI 助手与 Notion 工作空间之间的桥梁。通过这个服务器，AI 助手可以安全、标准地访问和操作您的 Notion 内容，例如查询数据库、创建和更新页面、管理块等，从而更有效地帮助用户管理 Notion 工作空间。

主要功能点

数据库操作:
- 查询数据库：支持按条件过滤和排序数据库内容。
- 创建数据库：允许AI助手根据用户指令创建新的 Notion 数据库，并自定义数据库属性。
- 更新数据库：支持修改现有数据库的结构和属性。
- 数据库搜索：可以在多个数据库中进行搜索。
页面操作:
- 创建页面：支持创建带有特定属性和内容的 Notion 页面。
- 检索页面：获取页面的内容和元数据。
- 更新页面属性：修改页面的属性信息。
- 页面搜索：支持跨页面搜索内容。
块操作 (即将推出):
- 检索块的子块。
- 在页面中添加新的块。
- 更新块内容。
- 删除块。

安装步骤

克隆仓库:

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

安装依赖: 确保您已安装 Bun (版本 v1.2.9 或更高)，然后在项目目录下运行：
```
bun install
```
配置 Notion API 密钥:
- 在项目根目录下创建 '.env' 文件。
- 在 '.env' 文件中添加您的 Notion 集成密钥，例如：
```
NOTION_API_KEY=您的Notion集成密钥
```
- 如何获取 Notion 集成密钥:
  - 访问 Notion Integrations 页面并创建一个新的集成。
  - 为您的集成命名，并选择适当的权限（例如，"读取内容"、"更新内容"）。
  - 复制 "Internal Integration Token" ，这就是您的 'NOTION_API_KEY'。
- 分享 Notion 内容给您的集成:
  - 在 Notion 中打开您希望集成访问的页面或数据库。
  - 点击页面右上角的 "···" 按钮。
  - 点击 "连接" 按钮，并选择您创建的集成。

启动服务器:

bun run src/index.ts

服务器配置 (MCP 客户端配置)

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要在客户端的配置文件中添加服务器信息。以 'claude_desktop_config.json' 为例，您需要配置 'mcpServers' 字段，示例如下：

{
  "mcpServers": {
    "notion": {
      "server name": "notion",  //  服务器名称，客户端用以标识和引用
      "command": "bun",        //  启动服务器的命令，这里使用 bun 运行时
      "args": ["run", "src/index.ts"], // 启动命令的参数，指定运行 src/index.ts 文件
      "working directory": "/absolute/path/to/notion-mcp", //  服务器程序的工作目录，请替换为 notion-mcp 仓库的绝对路径
      "environment variables": {  //  环境变量配置
        "NOTION_API_KEY": "your-integration-token" //  Notion API 密钥，请替换为您的集成密钥
      }
    }
  }
}

基本使用方法

确保 Notion MCP Server 成功启动并运行。
在您的 MCP 客户端（例如 Claude Desktop）中配置并连接到名为 "notion" 的 MCP 服务器。
AI 助手将能够通过注册的工具与您的 Notion 工作空间进行交互，例如：
- 使用 'notion-query-database' 工具查询 Notion 数据库。
- 使用 'notion-create-page' 工具在 Notion 中创建新的页面。
- 使用 'notion-search' 工具在 Notion 工作空间中搜索信息。

注意: 请确保您的 Notion 集成拥有访问和操作相关 Notion 内容的权限，并将集成添加到您希望 AI 助手访问的页面和数据库的 "连接" 中。

关键词

使用说明

信息