Research

Research MCP Server

This is a repository for the research project on the 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.