使用说明

项目简介

本项目是一个基于Model Context Protocol (MCP) 的服务器实现，旨在作为AI助手（如Claude）与Notion工作区之间的桥梁。通过此服务器，AI助手可以安全、可控地访问和操作您的Notion数据，从而实现更智能的工作流和自动化。

主要功能点

连接AI助手与Notion: 作为一个MCP服务器，允许AI助手通过标准协议连接到您的Notion工作区。
数据访问能力: 提供多种工具，使AI助手能够读取和查询Notion数据库、页面和内容块。
数据操作能力: 支持AI助手在Notion中创建、更新页面和数据库，以及管理内容块。
工具化接口: 将Notion API功能封装为一系列易于AI助手调用的工具，如查询数据库、创建页面等。
标准化协议: 基于MCP协议，确保与支持MCP协议的AI客户端的兼容性和互操作性。

安装步骤

环境准备:
- 确保已安装 Node.js (版本 14 或更高)。
- 拥有一个 Notion 账号。
- 如果您计划与 Claude 桌面应用一起使用，请确保已安装 Claude 桌面应用。
获取 Notion API 密钥:
- 访问 https://www.notion.so/my-integrations。
- 点击 " + New integration " 按钮。
- 填写集成名称（例如 "AI助手"），选择您的Notion工作区。
- 提交后，复制 "Internal Integration Token" (以 'secret_' 开头)。
设置 MCP 服务器:
- 下载或克隆此 GitHub 仓库到您的本地计算机。
- 打开终端或命令提示符，导航到仓库目录。
- 运行命令 'npm install' 安装项目依赖。
- 复制 '.env.example' 文件并重命名为 '.env'。
- 编辑 '.env' 文件，将 'your_notion_api_key_here' 替换为您在步骤2中获取的 Notion API 密钥，并保存文件。
连接 Notion 页面:
- 在 Notion 中，为您希望AI助手访问的每个页面或数据库进行授权。
- 点击页面右上角的 "..." -> "Add connections"。
- 找到并选择您在步骤2中创建的集成。

服务器配置

为了让MCP客户端（如Claude）连接到此服务器，您需要配置客户端的MCP服务器设置。以下是配置示例 (JSON 格式):

{
  "mcpServers": {
    "notion": {  // 服务器名称，可以自定义
      "command": "node",
      "args": [
        "path/to/server.js"  // 请替换为 server.js 文件的实际路径
      ]
    }
  }
}

配置参数说明:

'command': 启动服务器的命令，这里使用 'node' (假设您已将Node.js添加到系统PATH)。
'args': 传递给 'node' 命令的参数，这里指定了 'server.js' 文件的路径。请务必将 'path/to/server.js' 替换为 'server.js' 文件在您计算机上的实际路径。 例如，如果 'server.js' 位于 'C:\projects\mcpnotionslack\server.js'，则在Windows上应为 '"C:\\projects\\mcpnotionslack\\server.js"'，在macOS/Linux上应为 '"/Users/yourname/projects/mcpnotionslack/server.js"'。

请注意: MCP客户端通常允许您直接编辑配置文件（如 Claude Desktop 的 'claude_desktop_config.json'）或在客户端界面中配置MCP服务器连接。请参考您的MCP客户端的具体文档进行配置。

基本使用方法

配置完成后，启动您的MCP客户端，并确保它已连接到您配置的 Notion MCP 服务器。您可以通过自然语言指令指示AI助手使用以下工具与 Notion 工作区互动，例如：

"列出我的 Notion 数据库" (对应 'list-databases' 工具)
"在 '任务' 数据库中创建一个名为 '测试任务' 的新页面" (对应 'create-page' 工具)
"查询数据库 '项目' 中标题包含 '会议记录' 的条目" (对应 'query-database' 工具)

更多可用工具及其使用方法，请参考仓库 'README.md' 文件中 "Available Tools" 章节的详细说明。

关键词