Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client