使用说明

项目简介

本项目是一个 Model Context Protocol (MCP) 服务器，旨在通过 Cline VSCode 扩展，使用户能够方便地查询 Notion 知识库。它利用 Dify API 作为后端服务，将 Notion 数据接入 MCP 协议，从而实现与 LLM 客户端（如 Cline）的集成。

主要功能点

Notion 知识库查询: 允许用户通过自然语言提问，直接从 Notion 知识库中检索相关信息。
详细答案与引用: 服务器返回的答案不仅包含详细内容，还包括指向相关 Notion 页面的链接和页面 ID，方便用户追溯信息来源。
FastMCP 构建: 基于 FastMCP 框架构建，保证服务器的稳定性和性能。
易于安装和配置: 通过 'fastmcp install' 命令即可自动完成安装和配置，简化用户操作。

安装步骤

克隆仓库: 首先，将仓库克隆到本地：

git clone https://github.com/rickydata-indexer/notion_mcp_server.git
cd notion_mcp_server

配置 Dify API Key: 在项目根目录下创建 '.env' 文件，并填入你的 Dify API Key：
```
echo "DIFY_API_BACKEND_KEY=你的Dify_API_Key" > .env
```
请将 '你的Dify_API_Key' 替换为你实际的 Dify API Key。
安装服务器: 在 Cline VSCode 扩展中，使用 'fastmcp install' 命令安装服务器：
```
fastmcp install notion_mcp_server.py
```
此命令会自动安装依赖、配置 Cline 插件，并将服务器设置为可用状态。

服务器配置

MCP 服务器的配置主要在 Cline VSCode 扩展的配置文件中进行。'fastmcp install' 命令会自动完成配置，用户通常无需手动修改。以下是配置示例，展示了 Cline 客户端需要的信息：

{
  "mcpServers": {
    "notion-kb": {  // 服务器名称，在 Cline 中用于标识
      "command": "uv", // 启动命令，这里使用 uv 包管理器
      "args": [ // 启动参数
        "run",
        "--with", "fastmcp", // 使用 fastmcp 插件
        "--with", "python-dotenv", // 使用 python-dotenv 加载环境变量
        "--with", "requests", // 使用 requests 库
        "fastmcp", // 实际执行 fastmcp 命令
        "run",
        "/absolute/path/to/notion_mcp_server.py"  //  'notion_mcp_server.py' 脚本的绝对路径，安装脚本会自动替换为正确的路径
      ],
      "env": {
        "DIFY_API_BACKEND_KEY": "你的Dify_API_Key" // Dify API Key，从 .env 文件中读取
      }
    }
  }
}

注意： 上述配置中的 '/absolute/path/to/notion_mcp_server.py' 会在安装过程中被自动替换为 'notion_mcp_server.py' 文件的实际绝对路径。用户无需手动修改此路径。'DIFY_API_BACKEND_KEY' 会从 '.env' 文件中读取，也无需在此处手动配置。

基本使用方法

成功安装后，在 Cline VSCode 扩展中，你可以直接向你的 Notion 知识库提问。例如，在 Cline 的输入框中输入：

Tell me about internal tooling

服务器将会查询你的 Notion 知识库，并返回包含答案、相关 Notion 页面链接和页面 ID 的结果。

关键词