A simple, clean MCP server for AWS Athena integration
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"aws-athena-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# AWS Athena MCP Server A simple, clean MCP (Model Context Protocol) server for AWS Athena integration. Execute SQL queries, discover schemas, and manage query executions through a standardized interface. ## ✨ Features - **Simple Setup** - Get running in under 5 minutes - **Clean Architecture** - Modular, well-tested, easy to understand - **Essential Tools** - Query execution and schema discovery - **Type Safe** - Full type hints and Pydantic models - **Async Support** - Built for performance with async/await - **Good Defaults** - Works out of the box with minimal configuration ## 🚀 Quick Start ### 1. Install ```bash # From PyPI with uv (recommended for Claude Desktop) uv tool install aws-athena-mcp # From PyPI with pip pip install aws-athena-mcp # Or from source git clone https://github.com/ColeMurray/aws-athena-mcp cd aws-athena-mcp pip install -e . ``` ### 2. Configure Set the required environment variables: ```bash # Required export ATHENA_S3_OUTPUT_LOCATION=s3://your-bucket/athena-results/ # Optional (with defaults) export AWS_REGION=us-east-1 export ATHENA_WORKGROUP=primary export ATHENA_TIMEOUT_SECONDS=60 ``` ### 3. Run ```bash # Start the MCP server (if installed with uv tool install) aws-athena-mcp # Or run directly with uv (without installing) uv tool run aws-athena-mcp # Or run directly with uvx (without installing) uvx aws-athena-mcp # Or run directly with Python python -m athena_mcp.server ``` That's it! The server is now running and ready to accept MCP connections. ## 🤖 Claude Desktop Integration To use this MCP server with Claude Desktop: ### 1. Install Claude Desktop Download and install [Claude Desktop](https://claude.ai/download) if you haven't already. ### 2. Configure Claude Desktop Add the following configuration to your `claude_desktop_config.json`: **Location of config file:** - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` **…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.