Skip to main content
Glama

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.

Related MCP server: Notion MCP Server

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.

Available Tools

6 tools
create_new_survey_summaryD

Inputs: title (required), body.

get_property_definitionB

Get property definition for survey summary

Inputs: no named parameters.

get_survey_summariesC

Get survey summaries

Inputs: no named parameters.

get_survey_summaryD

Get survey summary

Inputs: page_id (required).

update_survey_summary_blockD

Inputs: page_id (required), body (required).

update_survey_summary_propertyC
Update survey summary property
To know definition of properties, use `get_property_definition` tool in advance.

Inputs: page_id (required), updates (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.3/5.0

    Scored across 6 tools

    Disambiguation4/5

    The tools are mostly distinct with clear purposes: creating, getting, and updating survey summaries, plus a property definition tool. However, 'get_survey_summaries' and 'get_survey_summary' could be slightly confusing due to similar names, but their descriptions clarify one fetches multiple summaries and the other a single one. No major overlap exists between other tools.

    Naming Consistency4/5

    The naming follows a consistent verb_noun pattern with snake_case throughout, such as 'create_new_survey_summary' and 'update_survey_summary_property'. The only minor deviation is 'get_property_definition' which uses a slightly different noun structure compared to others, but it still fits the overall pattern well.

    Tool Count5/5

    With 6 tools, this server is well-scoped for managing survey summaries in a research context. The count is appropriate, covering core operations like create, get, and update without being overwhelming or too sparse, making it efficient for agents to handle typical workflows.

    Completeness3/5

    The server provides good coverage for survey summary operations, including create, get, and update functions. However, there is a notable gap: no delete tool is present, which could limit full lifecycle management. Additionally, while property handling is included, the lack of a delete operation for survey summaries reduces completeness for CRUD workflows.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A server that connects to the Notion API and exposes functionality through Claude's Machine Context Protocol, enabling search, retrieval, querying, and creation of Notion pages and databases.
      5,773 npm
      MIT
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      An MCP server that enables natural language interaction with the Notion API, allowing users to search, comment, create pages, and access content within their Notion workspace.
      265,848 npm
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Python server that integrates MCP with Notion to automate documentation workflows and manage Notion pages via LLMs, supporting operations like creating, updating, and searching Notion content.
      1
      -