使用说明

项目简介

Notion MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它充当 AI 助手（例如 Claude）与您的 Notion 工作空间之间的桥梁。通过这个服务器，AI 助手可以安全地与您的 Notion 数据库、页面和内容块进行交互，实现数据访问和内容管理。

主要功能点

连接 Notion 工作空间: 允许 AI 助手连接到您的 Notion 知识库。
访问 Notion 数据: 支持 AI 助手查看和搜索 Notion 数据库、页面和内容块。
管理 Notion 内容: 允许 AI 助手创建、更新和删除 Notion 页面和数据库条目。
提供丰富工具: 内置多种工具，例如列出数据库、查询数据库、创建页面、更新页面、搜索内容等，满足多样化的 Notion 操作需求。

安装步骤

安装 Node.js: 确保您的计算机上已安装 Node.js (版本 14 或更高)。您可以从 Node.js 官网下载并安装。
获取 Notion API 密钥:
- 访问 Notion Integrations 页面。
- 点击 "New integration" 创建一个新的集成。
- 填写集成名称，例如 "MCP Server Integration"，并关联您的 Notion 工作空间。
- 提交后，复制 "Internal Integration Token"，这就是您的 Notion API 密钥。
下载 notionMCP 仓库:
- 访问 GitHub 仓库 https://github.com/Sjotie/notionMCP。
- 您可以选择下载 ZIP 文件或使用 Git 克隆仓库到本地。
进入项目目录: 使用命令行工具（如终端或命令提示符）导航到您下载或克隆的 'notionMCP' 文件夹。
安装依赖: 在项目目录下运行命令 'npm install'，安装项目所需的依赖包。

服务器配置

为了让 MCP 客户端（例如 Claude）连接到 notionMCP 服务器，您需要在客户端的配置文件中指定服务器的启动方式。以下是 Claude Desktop 客户端的配置示例 (通常位于 'claude_desktop_config.json' 文件中)，您可以参考此示例进行配置：

{
  "mcpServers": {
    "notion": {  // 服务器名称，可以自定义，例如 "notion"
      "command": "node",  // 启动服务器的命令，这里使用 Node.js 运行
      "args": [  // 启动命令的参数
        "server.js"  // 指定运行项目根目录下的 server.js 文件
      ],
      "env": {  // 环境变量配置
        "NOTION_API_KEY": "您的 Notion API 密钥"  // 请替换为您在 Notion 官网获取的 API 密钥
      }
    }
  }
}

'server name': 为您的服务器指定一个名称，例如 "notion"，这将在客户端配置中引用。
'command': 指定启动服务器的命令，通常为 "node"，表示使用 Node.js 运行 JavaScript 代码。
'args': 一个字符串数组，包含传递给启动命令的参数。这里 '"server.js"' 表示运行项目根目录下的 'server.js' 文件。请确保 'server.js' 文件路径正确。
'env': 一个键值对对象，用于设置环境变量。'NOTION_API_KEY' 用于存储您的 Notion API 密钥，服务器程序会读取此环境变量进行身份验证。

注意: 请将 '"您的 Notion API 密钥"' 替换为您在 Notion 官网获取的真实 API 密钥。 Claude 客户端会根据您配置的 'command' 和 'args' 启动 notionMCP 服务器，并使用 Stdio 协议与其通信。

基本使用方法

启动 notionMCP 服务器: 在命令行工具中，导航到 'notionMCP' 项目目录，并运行命令 'node server.js'。服务器成功启动后，您应该能在控制台看到 "Notion MCP Server running on stdio" 的提示信息。
在 AI 助手中使用: 配置完成后，在您的 AI 助手（如 Claude）中，您可以开始指示它与您的 Notion 工作空间进行交互。例如：
- 您可以询问 Claude: "请列出我的 Notion 数据库"。
- 您可以指示 Claude: "在我的 '项目管理' 数据库中创建一个名为 '新项目提案' 的页面"。
- 您可以要求 Claude: "搜索我的 Notion 中包含 '会议纪要' 的页面"。

AI 助手会通过 notionMCP 服务器调用相应的 Notion 工具，并将结果返回给您。

关键词