H Yanagawa Research MCP Server

🚀 Research MCP Server

This is a repository for an MCP server used in a research project.

🚀 Quick Start

✨ Features

• Run as an MCP server.
• Retrieve survey data from Notion.
• Create survey pages in Notion.

📦 Installation

Prerequisites

• Python 3.12.1 or higher
• uv 0.5.25 or higher
• Claude Desktop client

💻 Usage Examples

Basic Usage

1. Clone the repository.
2. Obtain a Notion token from Notion Integrations.
3. Create a database page in Notion and get the database ID. The database ID is the last part of the page URL.
4. Create a .env file as follows:

NOTION_TOKEN=[YOUR_NOTION_TOKEN]
NOTION_ROOT_DATABASE_ID=[YOUR_NOTION_DATABASE_ID]

5. Add an MCP server definition to claude_desktop.json:

{
  ...
  "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"
      ]
    }
  }
}

6. Restart the Claude Desktop client to start the Research MCP Server.
7. Let Claude execute the survey and view the results.