gen3-mcp

# Gen3 MCP Server A Model Context Protocol (MCP) server for interacting with Gen3 data commons, with GraphQL query validation to reduce hallucinations. ## Install and Configure These instructions are for using the server in a chat client. For development, see [Development](DEVELOPMENT.md). ```bash # Clone the repository git clone <repository-url> # Install uv curl -LsSf https://astral.sh/uv/install.sh | sh ``` ### Create Gen3 credentials file Create a file `credentials.json` containing your Gen3 API key: ```json { "api_key": "xxxx", "key_id": "xxxx" } ``` ### Configure chat client Example for Claude Desktop `~/.config/Claude/claude_desktop_config.json`: ```json { "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" } } } } ``` ## Example Usage in chat client [](https://claude.ai/share/db7e3a4b-a200-4bff-9e9c-0e43b6708f12) ## Available Tools The MCP server provides the following tools: ### Schema Discovery Tools - `schema_summary()` - Get overview of all entities and their relationships - `schema_entity_context(entity_name)` - Get detailed entity context with hierarchical position and GraphQL field names ### Query Building Tools - `query_template(entity_name, include_relationships=True, max_fields=20)` - Generate safe query templates with validated fields - `validate_query(query)` - Validate GraphQL query syntax and field names against schema ### Query Execution Tool - `execute_graphql(query)` - Execute validated GraphQL queries against the Gen3 data commons ### Resources - `gen3://info` - Information about the Gen3 instance - `gen3://endpoints` - Available API endpoints - `gen3://workflow` - Recommended workflow for exploring Gen3 data commons - `gen3://tools-by-category` - Tools organized by usage category ## Acknowledgments Built with [MCP (Model Context Protocol)](https://github.com/modelcontextprotocol) and designed for [Gen3 Data Commons](https://gen3.org/).