使用说明

项目简介

Notion MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端。它将 Notion API 的完整功能封装为一系列工具，供大型语言模型 (LLM) 调用。这使得 LLM 能够通过自然语言指令，直接在 Notion 中执行读取、创建、更新和删除页面等操作。

主要功能点

Notion API 工具化: 将 Notion 官方 API SDK 中的各项功能，如页面、数据库、Block、评论、用户操作等，转化为可供 LLM 调用的工具。
无缝集成 Notion: LLM 可以通过这些工具，直接与 Notion 工作空间进行交互，实现自动化工作流。
支持 MCP 协议: 基于标准的 MCP 协议构建，易于与兼容 MCP 协议的 LLM 客户端集成。
易于部署和使用: 通过简单的命令行启动，并提供了 Cursor 和 Claude Desktop 等客户端的配置示例。

安装步骤

安装 Node.js 和 npm: 确保你的环境中已安装 Node.js 和 npm (Node 包管理器)。

克隆仓库: 使用 git 命令克隆该仓库到本地：

git clone https://github.com/orbit-logistics/notion-mcp-server

进入项目目录: 使用 cd 命令进入克隆下来的项目目录：
```
cd notion-mcp-server
```
安装依赖: 运行 npm 命令安装项目所需的依赖包：
```
npm install
```
创建 Notion 集成: 访问 Notion 开发者文档，创建一个 Notion 集成，并获取 内部集成令牌 (Internal Integration Token)。同时，确保该集成被添加到你希望 LLM 访问的 Notion 页面或工作空间中，并授予必要的权限。

服务器配置

对于 MCP 客户端（例如 Cursor 或 Claude Desktop），你需要配置 MCP 服务器的启动命令。以下是配置信息，客户端需要填入这些信息以连接到 Notion MCP Server。

JSON 配置 (示例，用于 MCP 客户端配置)

{
  "serverName": "notion-mcp-server",
  "command": "npx",
  "args": [
    "-y",
    "@orbit-logistics/notion-mcp-server",
    "-t",
    "<your_notion_integration_token>" // 将 <your_notion_integration_token> 替换为你的 Notion 内部集成令牌
  ]
}

配置说明:

'serverName': 服务器名称，可以自定义，例如 "notion-mcp-server"。
'command': 启动服务器的命令，这里使用 'npx' 来运行 npm 包。
'args': 传递给启动命令的参数列表：
- '-y': 'npx -y' 参数，表示自动确认执行 npm 包。
- '@orbit-logistics/notion-mcp-server': 要执行的 npm 包名，即 Notion MCP Server。
- '-t': 指定 Notion 集成令牌的参数。
- '<your_notion_integration_token>': 需要替换为你实际的 Notion 内部集成令牌。

基本使用方法

启动服务器: 在项目根目录下，使用终端运行以下命令启动 Notion MCP Server，请务必将 '<your_notion_integration_token>' 替换为你的 Notion 内部集成令牌：
```
npx -y @orbit-logistics/notion-mcp-server -t <your_notion_integration_token>
```
服务器成功启动后，会在终端输出 "Sequential Thinking MCP Server running on stdio"。
配置 MCP 客户端: 打开你的 MCP 客户端（例如 Cursor 或 Claude Desktop）的设置，按照客户端的 MCP 服务器配置指南，填入上面提供的 JSON 配置信息。确保将 '<your_notion_integration_token>' 替换为你的实际令牌。
在 LLM 中使用工具: 配置完成后，你的 LLM 客户端应该能够检测到 Notion MCP Server 提供的工具。你可以通过自然语言指令，指示 LLM 调用这些工具来操作 Notion。例如，你可以让 LLM "在 Notion 中创建一个新的页面" 或 "搜索 Notion 中关于项目 X 的页面"。具体的工具名称和使用方式可以参考仓库中 'src/tools' 目录下的工具定义文件。

注意: 首次运行 'npx -y @orbit-logistics/notion-mcp-server' 命令时，'npx' 可能会下载 '@orbit-logistics/notion-mcp-server' 包，请耐心等待下载完成。

关键词