返回 MCP 目录
public公开dns本地运行

research-mcp-server

一个研究型MCP服务器项目,集成Notion数据交互功能

article

README

🚀 研究 MCP 服务器

本仓库专为研究项目打造,提供一个 MCP 服务器,可助力相关研究工作的开展。

点击此处

✨ 主要特性

  • 作为 MCP 服务器运行,为研究提供稳定的服务支持。
  • 能够从 Notion 中获取调查数据,方便数据收集。
  • 可在 Notion 中创建调查页面,便于研究人员操作。

📦 安装指南

先决条件

  • Python 3.12.1 或更高版本
  • uv 0.5.25 或更高版本
  • Claude 桌面客户端

💻 使用示例

基础用法

按照以下步骤操作,即可使用本 MCP 服务器:

  1. 克隆仓库。
  2. Notion 集成 获取一个 Notion 令牌。
  3. 在 Notion 中创建一个数据库页面并获取数据库 ID。数据库 ID 是页面 URL 的最后一部分。
  4. 创建一个 .env 文件,内容如下:
NOTION_TOKEN=[YOUR_NOTION_TOKEN]
NOTION_ROOT_DATABASE_ID=[YOUR_NOTION_DATABASE_ID]
  1. claude_desktop.json 中添加一个 MCP 服务器定义:
{
  ...
  "mcpServers": {
    "研究 MCP 服务器": {
      "command": "uv",
      "args": [
        "run",
        "--with", "mcp[cli]",
        "--with", "notion-client",
        "--with", "pydantic",
        "mcp",
        "运行",
        "/path/to/research-mcp-server/server.py"
      ]
    }
  }
}
  1. 重启 Claude 桌面客户端以启动研究 MCP 服务器。
  2. 让 Claude 执行调查并查看结果。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端