Release v1.0.1

Fixed

• Fixed incorrect uvx installation syntax in README documentation
• Updated Claude Desktop configuration examples to use correct uvx syntax (uvx aws-athena-mcp)
• Corrected installation instructions to use uv tool install aws-athena-mcp instead of non-existent uvx install

Changed

• Pinned fastMCP dependency to version 2.5.2 to avoid linting errors from newer versions
• Reordered Claude Desktop configuration options to prioritize uvx as the most common MCP pattern
• Updated example configuration file to use correct uvx syntax

Documentation

• Added three configuration options for Claude Desktop: uvx (recommended), installed tool, and uv tool run
• Improved installation instructions with multiple methods
• Enhanced troubleshooting section

Release v1.0.0

Added

• Initial release of AWS Athena MCP Server
• Core MCP tools for query execution:
  • run_query - Execute SQL queries against Athena
  • get_status - Check query execution status
  • get_result - Get results for completed queries
• Schema discovery tools:
  • list_tables - List all tables in a database
  • describe_table - Get detailed table schema
• Configuration management with environment variables
• AWS credentials validation
• Comprehensive error handling with structured responses
• Type-safe data models using Pydantic
• Async/await support for non-blocking operations
• Timeout handling for long-running queries
• JSON response formatting for all tools

Technical Details

• Built on FastMCP framework for MCP protocol compliance
• Uses boto3 for AWS Athena integration
• Supports Python 3.10+ with full type hints
• Modular architecture with clean separation of concerns
• Comprehensive input validation and error handling

Configuration

• ATHENA_S3_OUTPUT_LOCATION - Required S3 path for query results
• AWS_REGION - AWS region (default: us-east-1)
• ATHENA_WORKGROUP - Optional Athena workgroup
• ATHENA_TIMEOUT_SECONDS - Query timeout (default: 60)

Dependencies

• fastmcp>=0.1.0 - MCP protocol implementation
• boto3>=1.26.0 - AWS SDK for Python
• pydantic>=2.0.0 - Data validation and settings management

---

Release Process

Version Numbering

• Major (X.0.0): Breaking changes, major new features
• Minor (1.X.0): New features, backwards compatible
• Patch (1.0.X): Bug fixes, security updates

Release Checklist

• Update version in pyproject.toml
• Update CHANGELOG.md with release notes
• Run full test suite
• Update documentation if needed
• Create GitHub release with changelog
• Publish to PyPI (when ready)

Security Releases

Security fixes will be released as patch versions and clearly marked in the changelog with a Security section.