Skip to main content
Glama
README.md
# Research MCP Server

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

<a href="https://glama.ai/mcp/servers/54ktuin739"><img width="380" height="200" src="https://glama.ai/mcp/servers/54ktuin739/badge" alt="Research Server MCP server" /></a>

## 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](https://www.notion.so/my-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:
    ```shell
    NOTION_TOKEN=[YOUR_NOTION_TOKEN]
    NOTION_ROOT_DATABASE_ID=[YOUR_NOTION_DATABASE_ID]
    ```
5. Add an MCP server definition to `claude_desktop.json`:
    ```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.

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.

Maintenance

ActivityInactive
ResponsivenessNo issues