gen3-mcp

delocalizer/gen3-mcp

3.3

If you are the rightful owner of gen3-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Gen3 MCP Server is a Model Context Protocol server designed for interacting with Gen3 data commons, featuring GraphQL query validation to minimize hallucinations.

The Gen3 MCP Server is a specialized server that facilitates interaction with Gen3 data commons through the Model Context Protocol (MCP). It is designed to enhance data querying by incorporating GraphQL query validation, which helps in reducing errors and hallucinations in data retrieval. The server is particularly useful for users who need to access and manipulate large datasets within the Gen3 ecosystem, providing a robust interface for executing complex queries. By leveraging the capabilities of MCP, the server ensures that users can efficiently discover schema, build queries, and execute them with validated precision. This makes it an invaluable tool for researchers and data scientists working with Gen3 data commons, as it streamlines the process of data access and manipulation, ensuring accuracy and reliability in data-driven projects.

Features

  • GraphQL Query Validation: Ensures that queries are syntactically correct and fields are valid, reducing errors.
  • Schema Discovery: Provides tools to explore and understand the data schema, including entity relationships.
  • Query Execution: Allows for the execution of validated GraphQL queries against the Gen3 data commons.
  • Integration with Chat Clients: Can be configured to work with chat clients like Claude Desktop for seamless interaction.
  • Secure Access: Utilizes Gen3 API keys for secure data access and operations.

Usages

usage with Claude Desktop

{
  "mcpServers": {
    "gen3-mcp-server": {
      "command": "uvx",
      "args": [
        "--from", "/path/to/gen3-mcp",
        "gen3-mcp"
      ],
      "env": {
        "GEN3_CREDENTIALS_FILE": "/path/to/credentials.json",
        "GEN3_BASE_URL": "https://gen3.datacommons.io/",
        "GEN3_LOG_LEVEL": "INFO"
      }
    }
  }
}

Tools

  1. get_schema_summary

    Get annotated overview of all entities and their relationships.

  2. get_schema_entity

    Get detailed schema info about a specific entity including all fields.

  3. generate_query_template

    Generate safe query templates with validated fields.

  4. validate_query

    Validate GraphQL query syntax and field names against schema.

  5. execute_graphql

    Execute validated GraphQL queries against the Gen3 data commons.