关键词

Notion研究调查数据管理LLM工具Claude

使用说明

项目简介

Research Notion MCP Server 是一个研究项目，旨在构建一个 MCP (Model Context Protocol) 服务器，使得大型语言模型客户端（如 Claude 桌面客户端）能够访问和操作存储在 Notion 中的研究调查数据。通过此服务器，用户可以使用自然语言指令，让 Claude 等 LLM 执行如检索调查摘要、更新调查属性、创建新的调查总结等任务，从而提升研究工作流程的效率。

主要功能点

  • MCP 服务器功能: 作为一个标准的 MCP 服务器运行，可以与任何兼容 MCP 协议的客户端进行通信。
  • Notion 数据集成: 能够从指定的 Notion 数据库中检索调查数据，支持查询、读取和更新 Notion 页面和属性。
  • 调查数据管理: 允许用户通过 Claude 等客户端创建新的调查页面，并更新现有调查页面的属性和内容。
  • 工具 (Tools) 注册: 注册了多个工具函数，如 'get_survey_summaries' (获取调查摘要列表), 'get_survey_summary' (获取单个调查摘要), 'get_property_definition' (获取属性定义), 'update_survey_summary_property' (更新调查摘要属性), 'update_survey_summary_block' (更新调查摘要内容块), 'create_new_survey_summary' (创建新的调查摘要)，为 LLM 提供丰富的功能调用接口。
  • Prompt 模板 (Prompt): 定义了 'survey' Prompt 模板，用于指导 LLM 在执行调查相关任务时的行为。

安装步骤

  1. 克隆仓库: 首先，将 GitHub 仓库 'https://github.com/h-yanagawa/research-mcp-server' 克隆到本地。
  2. 获取 Notion Token: 访问 Notion Integrations 获取您的 Notion API Token (Internal Integration Token)。
  3. 创建 Notion 数据库: 在 Notion 中创建一个数据库页面，用于存储调查数据，并获取数据库 ID。数据库 ID 是页面 URL 的最后一部分。
  4. 配置环境变量: 在项目根目录下创建 '.env' 文件，并填入您的 Notion Token 和数据库 ID，例如： 
    NOTION_TOKEN=[YOUR_NOTION_TOKEN]
NOTION_ROOT_DATABASE_ID=[YOUR_NOTION_DATABASE_ID]
  5. 安装依赖: 确保您的 Python 版本为 3.12.1 或更高，并安装 'uv' (版本 0.5.25 或更高)。推荐使用 'uv' 进行包管理和运行。

服务器配置

要将 Research Notion MCP Server 集成到 MCP 客户端（例如 Claude 桌面客户端），您需要配置客户端的 'claude_desktop.json' 文件。在 'mcpServers' 部分添加如下配置信息：

{
  ...
  "mcpServers": {
    "Research Notion MCP Server": {
      "command": "uv",  // 启动服务器的命令，这里使用 uv
      "args": [         // 启动服务器命令的参数列表
        "run",        // uv run 命令，用于运行 Python 脚本
        "--with", "mcp[cli]", // 包含 mcp 库及其命令行界面 (cli) 支持
        "--with", "notion-client", // 包含 notion-client 库，用于与 Notion API 交互
        "--with", "pydantic",    // 包含 pydantic 库，用于数据验证和设置
        "mcp",        // 运行 mcp 命令
        "run",        // mcp run 子命令，用于启动 MCP 服务器
        "/path/to/research-mcp-server/server.py" //  服务器脚本 server.py 的绝对路径，请替换为您的实际路径
      ]
    }
  }
}

注意: 请将 '/path/to/research-mcp-server/server.py' 替换为您本地 'server.py' 文件的实际绝对路径。

基本使用方法

  1. 启动 Claude 桌面客户端: 配置完成后，重启 Claude 桌面客户端以加载 MCP 服务器配置。
  2. 与 Claude 交互: 现在您可以向 Claude 提出与研究调查相关的请求。例如，您可以询问 Claude 进行论文调查，并指示它将结果整理到 Notion 中。由于服务器定义了 Prompt 和 Tools，Claude 将能够理解您的意图，并调用相应的工具来访问和操作 Notion 数据。
  3. 查看结果: 您可以在您配置的 Notion 数据库中查看 Claude 执行调查任务的结果。

例如，您可以尝试向 Claude 提问：

  • "请帮我做一个关于 Transformer 模型的论文调研，并将结果整理到 Notion 中。"
  • "在 Notion 中创建一个新的调查总结页面，标题为 'BERT 模型分析'。"
  • "获取 Notion 中所有调查摘要的列表。"

信息

分类

生产力应用

访问项目