Skip to content

v0.2.0 - MCP Client Environment Variable Support

Latest
Latest

Choose a tag to compare

View all tags
@n0zer0d4y n0zer0d4y released this 15 Nov 13:24
· 32 commits to master since this release
v0.2.0
55d83d3

v0.2.0 - MCP Environment Variable Support

Overview

This release introduces comprehensive MCP client environment variable configuration support, enabling users to configure Athena Protocol directly through MCP client settings without requiring local .env files. This significantly improves the user experience for npm/npx installations.

New Features

MCP Client Configuration Support

  • Environment Variable Priority System: Implemented hierarchical configuration loading where MCP client env variables take precedence over local .env files
  • NPX Detection: Added intelligent detection of npx execution to skip unnecessary .env file loading
  • Flexible Provider Configuration: Support for configuring any combination of LLM providers through MCP client environment variables

GPT-5 Model Support

  • GPT-5 Specific Parameters: Added support for GPT-5 exclusive parameters:
    • OPENAI_MAX_COMPLETION_TOKENS_DEFAULT for controlling completion token limits
    • OPENAI_VERBOSITY_DEFAULT for verbosity control
    • OPENAI_REASONING_EFFORT_DEFAULT for reasoning effort configuration
  • Model-Aware Configuration: System now recognizes GPT-5 models and applies appropriate parameter handling

Google Gemini Integration

  • Native Gemini Support: Added complete support for Google Gemini models
  • Gemini-Specific Configuration: Streamlined configuration options for Gemini models

Documentation

Configuration Guides

  • CLIENT_MCP_CONFIGURATION_EXAMPLES.md: New comprehensive guide with tested MCP client configurations for both GPT-5 and Google Gemini setups
  • README.md Updates: Enhanced installation instructions with clear separation between local and npm usage patterns
  • Future Refactoring Plans: Documented roadmap for GPT-5 parameter optimization in upcoming releases

User Experience Improvements

  • Simplified Setup: Clear distinction between local development (with .env) and npm usage (with MCP env variables)
  • Configuration Validation: Improved error messages and troubleshooting guidance
  • Timeout Configuration: Added explanations for timeout settings optimized for different model types

Technical Changes

Environment Provider Architecture

  • TripleMergedEnvProvider: New environment provider that merges MCP env, .env file, and system environment variables with proper priority
  • ProcessEnvProvider: Direct access to process.env for MCP client variables
  • DotenvProvider: Optional .env file loading with fallback behavior

Backward Compatibility

  • Preserved Local Development: Existing .env file configurations remain fully functional
  • Graceful Degradation: System works with partial configurations and provides helpful error messages
  • Version String Updates: Updated version identifiers across all server components

Configuration Examples

GPT-5 Setup (New)

{
  "mcpServers": {
    "athena-protocol": {
      "command": "npx",
      "args": ["@n0zer0d4y/athena-protocol"],
      "env": {
        "DEFAULT_LLM_PROVIDER": "openai",
        "OPENAI_API_KEY": "your-key-here",
        "OPENAI_MODEL_DEFAULT": "gpt-5",
        "OPENAI_MAX_COMPLETION_TOKENS_DEFAULT": "8192",
        "OPENAI_VERBOSITY_DEFAULT": "medium",
        "OPENAI_REASONING_EFFORT_DEFAULT": "high",
        "LLM_TEMPERATURE_DEFAULT": "0.7",
        "LLM_MAX_TOKENS_DEFAULT": "2000",
        "LLM_TIMEOUT_DEFAULT": "30000"
      }
    }
  }
}

Google Gemini Setup (New)

{
  "mcpServers": {
    "athena-protocol": {
      "command": "npx",
      "args": ["@n0zer0d4y/athena-protocol"],
      "env": {
        "DEFAULT_LLM_PROVIDER": "google",
        "GOOGLE_API_KEY": "your-key-here",
        "GOOGLE_MODEL_DEFAULT": "gemini-2.5-flash",
        "LLM_TEMPERATURE_DEFAULT": "0.7",
        "LLM_MAX_TOKENS_DEFAULT": "2000",
        "LLM_TIMEOUT_DEFAULT": "30000"
      }
    }
  }
}

Known Limitations

GPT-5 Parameter Requirements

Current implementation requires standard LLM parameters (LLM_TEMPERATURE_DEFAULT, LLM_MAX_TOKENS_DEFAULT, LLM_TIMEOUT_DEFAULT) for GPT-5 models, even though these parameters are not used by the model itself. This is a temporary limitation that will be addressed in v0.3.0.

Migration Guide

For Existing Local Users

No changes required. Existing .env file configurations continue to work unchanged.

For New NPM Users

Use the MCP client configuration examples provided in docs/CLIENT_MCP_CONFIGURATION_EXAMPLES.md for immediate setup.

Testing

  • Comprehensive testing with both local and npx execution modes
  • Validation of all documented configuration examples
  • Cross-platform compatibility verification (Windows, macOS, Linux)

Acknowledgments

This release represents a significant improvement in user experience by eliminating the need for local file configuration when using Athena Protocol through MCP clients. The foundation is now set for future enhancements and additional provider support.

Assets 2
Loading