Qualitative Researcher MCP Server

A sophisticated query tool for exploring, analyzing, and retrieving complex information from the qualitative research knowledge graph.

When to use this tool:

• Retrieving a comprehensive view of your entire research knowledge structure

• Searching for specific research entities across your qualitative data corpus

• Getting detailed information about particular research projects, participants, or analytical elements

• Exploring relationships between research components (codes, themes, quotes)

• Analyzing code frequencies and distributions across your data

• Retrieving interview or observation transcripts for analysis

• Accessing memo content for reflection on the research process

• Generating codebooks or analytical frameworks for documentation

• Finding connections between different aspects of your research

• Creating research reports or summaries from your data

• Exploring thematic structures and their evidentiary basis

• Identifying entities by status to track research progress

• Filtering tasks by priority to manage research workflow

• Analyzing sequential relationships between research processes

Key features:

• Offers specialized operations for querying different aspects of qualitative research data

• Retrieves complete or filtered views of the research knowledge graph

• Provides flexible search capabilities across all research entities

• Supports detailed exploration of specific entities by name

• Generates specialized views for projects, participants, codes, and themes

• Retrieves content and metadata for interviews, transcripts, and memos

• Creates codebooks and thematic frameworks for documentation

• Identifies related entities to explore connections within your research

• Returns consistently structured JSON responses for easy processing

• Facilitates depth and breadth exploration of qualitative data

• Supports status-based filtering of research entities

• Enables priority-based task management

• Provides sequential process analysis capabilities

Parameters explained:

1. type: The type of query operation to perform

• Accepts one of the specialized operations: "graph", "search", "nodes", "project", "participant", "codes", "themes", "transcript", "memo", "analysis", "codebook", "related", "status", "priority", "sequence"

• Determines how the params parameter is interpreted

2. params: Operation-specific parameters (structure varies by type):

• For "graph": No parameters needed (retrieves the full research knowledge graph)

• For "search": Object containing:

  • query: Search string to find entities (supports entity type filters)

• For "nodes": Object containing:

  • names: Array of entity names to retrieve

• For "project": Object containing:

  • projectName: Name of the project to retrieve details for

• For "participant": Object containing:

  • participantName: Name of the participant to retrieve profile for

• For "codes": Object containing:

  • projectName: (Optional) Project name to filter codes by

• For "themes": Object containing:

  • projectName: (Optional) Project name to filter themes by

• For "transcript": Object containing:

  • participantName: Participant associated with the transcript

  • interviewId: (Optional) Specific interview identifier

• For "memo": Object containing:

  • memoName: Name of the memo to retrieve

• For "analysis": Object containing:

  • projectName: Project name to retrieve analysis artifacts for

• For "codebook": Object containing:

  • projectName: Project name to generate codebook for

• For "related": Object containing:

  • entityName: Name of the entity to find related entities for

• For "status": Object containing:

  • statusValue: The status value to filter by (e.g., "planning", "data_collection", "analysis")

• For "priority": Object containing:

  • priorityValue: The priority value to filter by (e.g., "high", "low")

• For "sequence": Object containing:

  • entityName: Name of the entity to find sequential relationships for

Operation details:

• graph: Returns the complete research knowledge graph with all entities and relationships

• search: Performs text-based search across entity names and observations

• nodes: Retrieves detailed information about specific entities by name

• project: Returns comprehensive project information including participants, interviews, codes, and findings

• participant: Generates a participant profile with demographic information and associated data

• codes: Lists all codes, optionally filtered by project, with reference counts and descriptions

• themes: Returns all themes, optionally filtered by project, with associated codes and descriptions

• transcript: Retrieves interview transcript content for specific participant/interview combinations

• memo: Returns the full content of an analytical memo with metadata

• analysis: Collects all analysis artifacts (codes, themes, memos) for a specific project

• codebook: Generates a structured codebook for a project with code definitions and examples

• related: Identifies all entities directly connected to a specific entity

• status: Retrieves all entities with a specific status value

• priority: Retrieves all entities with a specific priority value

• sequence: Identifies sequential relationships for a specific entity showing preceding and following entities

Status and Priority Information:

• Status queries return entities organized by their current research stage

• Priority queries help identify critical research tasks and elements

• Status values include: planning, data_collection, analysis, writing, complete, scheduled, conducted, transcribed, coded, analyzed, emerging, developing, established, preliminary, draft, final, active, in_progress

• Priority values include: high, low

Sequential Process Information:

• Sequence queries identify entities that come before or after in a research process

• Sequential relationships help visualize the research workflow

• The sequence operation shows both incoming and outgoing precedes relations

Return information:

• JSON response with a consistent structure:

  • success: Boolean indicating whether the operation succeeded

  • Additional fields depend on the operation type:

    • graph: Complete knowledge graph

    • results: For search operations

    • nodes: For specific entity retrieval

    • project/participant/etc.: For specialized views

    • status/priority: Lists of entities with specified status/priority values

    • sequence: Preceding and following entities in research processes

• Error information when operations fail

You should:

• Start with broad queries ("graph", "search") to explore your research corpus

• Use specific entity queries ("nodes", "project", "participant") for detailed information

• Combine search and related queries to discover connections in your data

• Generate codebooks and project overviews for documentation and reporting

• Use transcript retrieval to access primary data when needed

• Explore thematic structures through themes and related entity queries

• Review memos to track your analytical process over time

• Filter code and theme queries by project for more focused results

• Use search with entity type filters to find specific types of research elements

• Use status queries to identify all entities at a particular research stage

• Use priority queries to focus on high-priority research tasks

• Use sequence queries to understand process flows in your research methodology