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

h-yanagawa_research-mcp-server

一个研究型MCP服务器项目,主要功能包括作为MCP服务器运行、从Notion获取调查数据以及在Notion中创建调查页面。

article

README

🚀 研究 MCP 服务器

本仓库是用于研究项目的 MCP 服务器,可作为 MCP 服务器运行,还能从 Notion 检索调查数据并创建调查页面。

🚀 快速开始

特性

  • ✨ 作为 MCP 服务器运行。
  • ✨ 从 Notion 检索调查数据。
  • ✨ 在 Notion 中创建调查页面。

先决条件

  • 🐍 Python 3.12.1 或更高版本
  • 📦 uv 0.5.25 或更高版本
  • 💻 Claude Desktop 客户端

使用方法

  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 Desktop 客户端以启动研究 MCP 服务器。
  2. 让 Claude 执行调查并查看结果。
help

运行方式说明

cloud

托管运行

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

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

本地运行 / 其它方式

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

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