Notion MCP Server 1y7

Notion MCP服务器是一个连接AI助手与Notion工作空间的桥梁，通过标准化的Model Context Protocol协议，实现AI对Notion数据库、页面和内容块的程序化访问与操作。

笔记工具知识管理与记忆 #Notion集成 #AI助手 #数据桥接 #协议服务 .TypeScript

评分 : 2.5分

下载量 : 8.7K

更新时间 : 2025-04-23

打开站点

什么是Notion MCP Server?

Notion MCP Server是一个标准化接口，允许AI助手通过Notion Model Context Protocol (MCP)与您的Notion工作区进行交互。它支持访问和操作数据库、页面以及块等内容。

如何使用Notion MCP Server?

首先安装并配置服务器，然后在Claude Desktop中添加配置文件以启用连接。您可以开始查询数据库、创建页面或执行其他操作。

适用场景

适用于需要自动化管理Notion内容的团队和个人，例如项目管理、知识库维护和协作工具集成。

主要功能

查询数据库

根据过滤条件和排序规则查询Notion数据库中的记录。

创建数据库

在Notion中创建具有自定义属性的新数据库。

获取页面

检索特定页面的内容及其元数据。

搜索页面

在整个工作区中按标题搜索页面。

追加块

向现有页面中添加新的块内容。

优势

简化AI助手与Notion之间的交互流程。

支持高度定制化的数据库和页面操作。

提供统一的API接口，便于集成到多种系统中。

局限性

需要预先配置Notion API密钥和权限。

某些高级功能可能仍处于开发阶段。

对网络环境有一定依赖性。

如何使用

安装Notion MCP Server

克隆仓库并安装依赖项。

配置环境变量

创建.env文件并填写Notion API密钥。

启动服务器

运行脚本以启动MCP服务。

配置Claude Desktop

编辑配置文件以连接到MCP服务器。

使用案例

查询已完成任务

获取所有状态为“完成”的任务。

创建新任务

向任务数据库添加一条新记录。

常见问题

为什么我的查询失败？

如何更新已有的数据库？

🚀 Notion MCP 服务器

Notion MCP 服务器是为 Notion API 实现的模型上下文协议 (MCP) 服务器，它让 AI 助手能以程序化的方式与 Notion 工作区交互。该服务器为大语言模型 (LLM) 提供了标准化接口，可用于访问和操作 Notion 中的数据库、页面和块等内容。

🚀 快速开始

先决条件

Node.js 和 npm（版本 14 或更高）
Docker（用于可选的 Docker 支持）

创建 Notion 集成

访问 Notion 开发人员面板
创建一个新的集成并获取 API 密钥

共享内容

将新创建的集成邀请到您的 Notion 工作区或特定页面/数据库

安装

克隆此仓库：

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

安装依赖项：
```
npm install
```

配置

复制 .env.example 到 .env 文件：
```
cp .env.example .env
```
在 .env 文件中设置以下变量：
- NOTION_API_KEY: 您的 Notion API 密钥
- NOTION_WORKSPACE_ID: 您的工作区 ID

启动服务器

npm run dev

配置 Claude Desktop

在 config.ts 文件中设置以下内容：

export const config = {
  tools: {
    notion: {
      apiKey: process.env.NOTION_API_KEY,
      workspaceId: process.env.NOTION_WORKSPACE_ID,
    },
  },
};

✨ 主要特性

什么是 MCP？

模型上下文协议 (MCP) 是一种将大型语言模型 (LLM) 与其外部工具、数据源和 API 相连接的标准协议。它允许 AI 助手以安全且标准化的方式访问功能和数据。此 Notion MCP 服务器实现了该协议，使 AI 助手能够访问您的 Notion 工作区。

项目目的

该项目作为桥梁，将 AI 助手与 Notion 工作区连接起来，允许 AI 工具执行以下操作：

查询并搜索数据库
检索和创建页面
更新页面属性和内容
创建和更新数据库
（即将推出）管理块及其内容

通过为 Notion 实现 MCP 协议，此服务器使 AI 助手能够更高效地帮助用户管理其 Notion 工作区。

功能

Notion MCP 服务器实现了以下功能：

数据库操作

使用过滤和排序查询数据库
创建具有自定义属性的新数据库
更新现有数据库模式和属性
搜索数据库

页面操作

使用属性和内容创建页面
检索页面内容和元数据
更新页面属性
（即将推出）管理块及其内容

📦 安装指南

先决条件

Node.js 和 npm（版本 14 或更高）
Docker（用于可选的 Docker 支持）

创建 Notion 集成

访问 Notion 开发人员面板
创建一个新的集成并获取 API 密钥

共享内容

将新创建的集成邀请到您的 Notion 工作区或特定页面/数据库

安装

克隆此仓库：

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

安装依赖项：
```
npm install
```

配置

复制 .env.example 到 .env 文件：
```
cp .env.example .env
```
在 .env 文件中设置以下变量：
- NOTION_API_KEY: 您的 Notion API 密钥
- NOTION_WORKSPACE_ID: 您的工作区 ID

启动服务器

npm run dev

配置 Claude Desktop

在 config.ts 文件中设置以下内容：

export const config = {
  tools: {
    notion: {
      apiKey: process.env.NOTION_API_KEY,
      workspaceId: process.env.NOTION_WORKSPACE_ID,
    },
  },
};

💻 使用示例

基础用法

由于文档未提供基础用法的代码示例，暂无法展示。

高级用法

由于文档未提供高级用法的代码示例，暂无法展示。

📚 详细文档

工具

数据库工具

queryDatabase: 查询 Notion 数据库
createDatabase: 创建新的数据库
updateDatabase: 更新现有数据库属性

页面工具

createPage: 使用属性和内容创建页面
retrievePage: 检索特定页面的内容和元数据
updatePage: 更新页面的属性和内容

项目结构

notion-mcp/
├── src/
│   ├── services/
│   │   └── notion.ts             # Notion 客户端服务  
│   ├── config.ts                 # 应用配置
│   ├── env.ts                    # t3-env 模式 
│   ├── index.ts                  # 服务器入口点
│   ├── utils/
│   │   └── error-handling.ts     # 错误处理工具
│   └── tools/
│       ├── index.ts              # 导出所有工具
│       ├── 数据库/            # 数据库相关工具
│       │   ├── handler.ts        # 数据库操作处理器
│       │   ├── index.ts          # 导出数据库工具
│       │   └── schema.ts         # Zod 模式用于数据库操作
│       └── pages/                # 页面相关工具
│           ├── handler.ts        # 页面操作处理器
│           ├── index.ts          # 导出页面工具
│           └── schema.ts         # Zod 模式用于页面操作
├── tsconfig.json
├── package.json  
├── todos.md
├── README.md
└── bun.lock