使用说明

项目简介

Research MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在连接大型语言模型 (LLM) 应用（如 Claude）与 Notion。通过这个服务器，用户可以使用自然语言指令，让 LLM 助手执行论文调研、数据整理等任务，并将调研结果以结构化的方式存储在指定的 Notion 数据库中。它允许 LLM 客户端通过工具调用来访问和操作 Notion 中的数据，从而扩展 LLM 的能力边界，使其能够与外部知识库和应用进行交互。

主要功能点

连接 Notion 数据库: 允许 LLM 访问和操作指定的 Notion 数据库，用于存储和管理调研数据。
论文调研助手: 作为一个论文调研助手，帮助用户整理和总结论文信息。
结构化数据存储: 将调研结果以结构化的方式存储在 Notion 数据库中，方便后续检索和利用。
Prompt 定制: 提供 Prompt 模板，可以根据需要定制 LLM 的交互方式和指令。
工具集成: 内置多个工具，用于查询、更新和创建 Notion 数据库中的页面和属性。

安装步骤

克隆仓库: 首先，将仓库 'h-yanagawa_research-mcp-server' 克隆到本地：

git clone https://github.com/MCP-Mirror/h-yanagawa_research-mcp-server
cd h-yanagawa_research-mcp-server

获取 Notion Token: 访问 Notion Integrations 创建一个新的集成，并获取你的 Notion Token (Secret)。
获取 Notion 数据库 ID: 在 Notion 中创建一个数据库页面，用于存储调研数据。数据库 ID 是该页面 URL 的最后一部分。例如，如果页面 URL 是 'https://www.notion.so/your-workspace/your-database-title-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'，则数据库 ID 为 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'。

配置环境变量: 在项目根目录下创建 '.env' 文件，并填入你的 Notion Token 和数据库 ID：

NOTION_TOKEN=[YOUR_NOTION_TOKEN]
NOTION_ROOT_DATABASE_ID=[YOUR_NOTION_DATABASE_ID]

将 '[YOUR_NOTION_TOKEN]' 替换为你获取的 Notion Token，'[YOUR_NOTION_DATABASE_ID]' 替换为你的数据库 ID。

安装依赖并运行服务器: 根据 'README.md' 的指示，你需要安装 Python 3.12.1 或更高版本以及 'uv'。然后，可以使用以下命令运行服务器：
```
uv run --with mcp[cli] --with notion-client --with pydantic mcp run server.py
```
注意: 首次运行可能需要安装依赖，请根据提示操作。

服务器配置 (Claude Desktop Client)

要将 Research MCP Server 集成到 Claude Desktop Client 中，你需要编辑 'claude_desktop.json' 配置文件（通常位于 Claude Desktop Client 的安装目录下）。在 'mcpServers' 字段中添加如下配置：

{
  "mcpServers": {
    "Research MCP Server": {
      "command": "uv",
      "args": [
        "run",
        "--with", "mcp[cli]",
        "--with", "notion-client",
        "--with", "pydantic",
        "mcp",
        "run",
        "/path/to/research-mcp-server/server.py"  // 将 "/path/to/research-mcp-server/server.py" 替换为你的 server.py 文件的实际路径
      ]
    }
  }
}

配置参数说明:

'"Research MCP Server"': 服务器名称，在 Claude Desktop Client 中显示。
'"command": "uv"': 启动服务器的命令，这里使用 'uv run'。
'"args": [...]': 启动命令的参数列表。
- '"run"': 'uv run' 命令本身。
- '"--with", "mcp[cli]"': 指定运行环境包含 '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' 文件的实际绝对路径。例如，如果你的项目在 '/Users/yourname/research-mcp-server' 目录下，则应替换为 '"/Users/yourname/research-mcp-server/server.py"'。

配置完成后，重启 Claude Desktop Client 以加载 Research MCP Server。

基本使用方法

启动 Claude Desktop Client 后，在对话框中可以指示 Claude 使用 "Research MCP Server" 执行论文调研任务。
例如，你可以向 Claude 提问： "请帮我调研一下关于大型语言模型在教育领域的应用，并将结果整理到 Notion 中。"
Claude 将会调用 Research MCP Server 提供的工具，与 Notion 数据库进行交互，并将调研结果存储到你配置的数据库中。
你可以在 Notion 数据库中查看和管理调研结果。

注意: 首次使用可能需要 Claude 授权访问 Research MCP Server。请根据 Claude 的提示进行操作。

关键词