Research MCP Server

🚀 Research MCP Server

This repository contains an MCP server for a research project.

✨ Features

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

📋 Prerequisites

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

🚀 Quick Start

📦 Installation

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 in 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 conduct the survey and view the results.