项目简介

Notion MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,旨在为大型语言模型 (LLM) 提供与 Notion 工作空间无缝集成的能力。通过此服务器,LLM 可以利用标准化的工具来搜索、读取、创建和更新您的 Notion 页面,从而扩展 LLM 在知识管理和信息处理方面的应用。

主要功能点

  • 搜索页面: 允许 LLM 在您的 Notion 工作空间中执行关键词搜索,快速找到相关页面。
  • 读取页面: 使 LLM 能够读取指定 Notion 页面的内容,获取页面内的文本信息。
  • 创建页面: 支持 LLM 在 Notion 工作空间中创建新的页面,可以指定标题和内容。
  • 更新页面: 允许 LLM 向现有 Notion 页面追加或修改内容,实现动态内容更新。

安装步骤

  1. 克隆仓库 打开终端,执行以下命令克隆仓库到本地:

    git clone https://github.com/MCP-Mirror/v-3_notion-server.git
    cd v-3_notion-server
  2. 安装依赖 确保您已安装 Node.js (v16 或更高版本) 和 npm。在项目根目录下运行以下命令安装项目依赖:

    npm install
  3. 配置 Notion API 密钥 在项目根目录下创建 '.env' 文件,并添加您的 Notion API 密钥。您需要在 Notion 官方网站上创建集成并获取密钥。

    NOTION_API_KEY=您的_Notion_API_密钥

    请将 '您的_Notion_API_密钥' 替换为您实际的 Notion API 密钥。

  4. 构建服务器 运行以下命令构建服务器代码:

    npm run build

    构建成功后,会在项目根目录下生成 'build' 文件夹,其中包含编译后的服务器代码。

服务器配置

要将 Notion MCP Server 集成到 MCP 客户端(例如 Claude Desktop),您需要在客户端的配置文件中添加服务器配置信息。以下是 Claude Desktop 的 'claude_desktop_config.json' 配置文件示例,展示如何配置 Notion MCP Server:

{
    "mcpServers": {
        "notion": {
            "command": "node",
            "args": ["/absolute/path/to/v-3_notion-server/build/index.js"]
        }
    }
}

配置参数说明

  • '"notion"': 服务器名称,您可以自定义,用于在客户端中标识该服务器。
  • '"command"': 启动服务器的命令,这里使用 'node' 命令来运行 JavaScript 代码。
  • '"args"': 启动命令的参数,指向服务器入口文件 'build/index.js' 的绝对路径。请将 '/absolute/path/to/v-3_notion-server' 替换为您本地仓库的实际绝对路径。

注意: 您需要在 Claude Desktop 或其他 MCP 客户端的配置文件中,根据实际情况修改 'args' 中的路径,确保指向 'build/index.js' 文件的正确位置。 'NOTION_API_KEY' 环境变量已经在您的 '.env' 文件中配置,服务器运行时会自动读取。

基本使用方法

  1. 启动服务器: 当您在 MCP 客户端(如 Claude Desktop)中配置并启动 Notion MCP Server 后,服务器会在后台运行。

  2. 使用工具: 在 MCP 客户端中,您可以调用以下工具与您的 Notion 工作空间进行交互:

    • 'search_pages': 用于搜索 Notion 页面。
    • 'read_page': 用于读取 Notion 页面内容。
    • 'create_page': 用于创建新的 Notion 页面。
    • 'update_page': 用于更新现有 Notion 页面内容。

    具体工具的使用方法和参数,请参考仓库 'README.md' 文件中 "Available Tools" 部分的说明。您可以在 MCP 客户端的界面或通过指令来调用这些工具,从而实现 LLM 对 Notion 工作空间的访问和操作。

信息

分类

生产力应用