Astra MCP Server

# ============================================================================= # Agentic Astra MCP Server - Environment Variables Sample # ============================================================================= # Copy this file to .env and fill in your actual values # cp env.sample .env # ============================================================================= # ============================================================================= # REQUIRED: Astra DB Configuration # ============================================================================= # These are required for the server to connect to your Astra DB instance # Get these from your DataStax Astra DB dashboard # REQUIRED: Your Astra DB application token # This is required and must be provided either here or via --astra_token argument ASTRA_DB_APPLICATION_TOKEN=your_astra_db_application_token_here # OPTIONAL: Astra DB API endpoint URL # Format: https://{database-id}-{region}.apps.astra.datastax.com # If not provided, the server will attempt to discover it ASTRA_DB_API_ENDPOINT=https://your-database-id-your-region.apps.astra.datastax.com # OPTIONAL: Astra DB database name # If not provided, the server will attempt to discover it from the endpoint ASTRA_DB_DB_NAME=your_database_name # OPTIONAL: Catalog collection name for storing tool definitions # Default: tool_catalog ASTRA_DB_CATALOG_COLLECTION=tool_catalog # OPTIONAL: Audit trail table name (used when --audit flag is enabled) # Default: mcp_audit_trail ASTRA_DB_AUDIT_TABLE_NAME=mcp_audit_trail # ============================================================================= # Server Configuration # ============================================================================= # These control how the MCP server runs # OPTIONAL: Host to bind the server to (for HTTP/SSE transport) # Default: 127.0.0.1 HOST=127.0.0.1 # OPTIONAL: Port to bind the server to (for HTTP/SSE transport) # Default: 8000 PORT=8000 # ============================================================================= # Logging Configuration # ============================================================================= # OPTIONAL: Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL) # Default: info LOG_LEVEL=INFO # OPTIONAL: Log file path # Default: logs.log LOG_FILE=logs/logs.log # ============================================================================= # Authorization Configuration # ============================================================================= # These control authentication for the MCP server # OPTIONAL: Token for authenticating MCP client requests # If not provided, authentication is disabled AGENTIC_ASTRA_TOKEN=your_agentic_astra_token_here # OPTIONAL: Legacy token name (for backward compatibility) # If AGENTIC_ASTRA_TOKEN is not set, this will be used ASTRA_MCP_SERVER_TOKEN=your_agentic_astra_token_here # ============================================================================= # LLM and Embedding Configuration # ============================================================================= # These are used for generating embeddings # ============================================================================= # OpenAI Configuration # ============================================================================= # Used for embeddings and LLM prompts when using OpenAI models # OPTIONAL: OpenAI API key # Required if using OpenAI for embeddings or LLM prompts OPENAI_API_KEY=your_openai_api_key_here # OPTIONAL: OpenAI API base URL # Default: https://api.openai.com/v1 # Can be used to point to OpenAI-compatible APIs (e.g., local models) OPENAI_BASE_URL=https://api.openai.com/v1 # ============================================================================= # IBM Watsonx Configuration # ============================================================================= # Used for embeddings and LLM prompts when using IBM Watsonx models # OPTIONAL: IBM Watsonx API key # Required if using IBM Watsonx for embeddings or LLM prompts IBM_WATSONX_API_KEY=your_ibm_watsonx_api_key_here # OPTIONAL: IBM Watsonx base URL # Format: https://{cluster_url}/ml/v1/text/embeddings?version=2023-10-25 # Required if using IBM Watsonx IBM_WATSONX_BASE_URL=https://your-cluster-url/ml/v1/text/embeddings?version=2023-10-25 # OPTIONAL: IBM Watsonx project ID # Required if using IBM Watsonx IBM_WATSONX_PROJECT_ID=your_ibm_watsonx_project_id_here # ============================================================================= # Notes # ============================================================================= # - All values marked as OPTIONAL have defaults or can be provided via command-line arguments # - Values marked as REQUIRED must be provided either here or via command-line arguments # - You can also use the --env-file argument to load a different .env file # - You can use --env-var KEY=VALUE to set individual environment variables via command line # - Command-line arguments take precedence over environment variables # =============================================================================