research-mcp-server

research-mcp-server

1

The Research MCP Server is designed to function as a Model Context Protocol server, enabling the integration and retrieval of survey data with Notion. It includes features to facilitate survey creation and management directly through the Notion platform.

Research MCP Server

This is a repository for the research project on the MCP server.

Research Server MCP server

Features

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

Prerequisites

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

How to Use

  1. Clone the repository.
  2. Obtain a Notion token from Notion Integrations.
  3. Create a database page in Notion and retrieve the database ID. The database ID is the last part of the page URL.
  4. Create a .env file as shown below:
    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 launch the Research MCP Server.
  7. Ask Claude to perform a survey and review the results.