mcp-instana 0.3.0__py3-none-any.whl → 0.3.1__py3-none-any.whl

{mcp_instana-0.3.0.dist-info → mcp_instana-0.3.1.dist-info}/METADATA

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: mcp-instana
-Version: 0.3.0
+Version: 0.3.1
 Summary: MCP server for Instana
 Author-email: Elina Priyadarshinee <Elina.priyadarshinee1@ibm.com>, Guangya Liu <gyliu@ibm.com>, Isabell Sippli <ischwert@de.ibm.com>, Jay Sharma <Jay.Sharma3@ibm.com>, Madhu Tadiparthi <madhu.tadiparthi@ibm.com>, Riya Kumari <Riya.Kumari3@ibm.com>
 License: Apache-2.0
 License-File: LICENSE.md
 Requires-Python: >=3.10
 Requires-Dist: fastmcp==2.10.3
-Requires-Dist: instana-client==1.0.0
+Requires-Dist: instana-client==1.0.1
 Requires-Dist: mcp
 Requires-Dist: pydantic==2.11.7
 Requires-Dist: python-dotenv==1.1.0
@@ -24,6 +24,7 @@ Description-Content-Type: text/markdown
 
 <!-- START doctoc generated TOC please keep comment here to allow auto update -->
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+<!-- mcp-name: io.github.instana/mcp-instana -->
 **Table of Contents**
 
 - [MCP Server for IBM Instana](#mcp-server-for-ibm-instana)
@@ -78,6 +79,10 @@ Description-Content-Type: text/markdown
       - [**Basic Usage**](#basic-usage)
       - [**Environment Variables**](#environment-variables)
       - [**Docker Compose Example**](#docker-compose-example)
+    - [Multi-Architecture Support](#multi-architecture-support)
+      - [**Supported Architectures**](#supported-architectures)
+      - [**Benefits of Multi-Architecture Images**](#benefits-of-multi-architecture-images)
+      - [**How It Works**](#how-it-works)
     - [Docker Security Features](#docker-security-features)
       - [**Security Best Practices Implemented**](#security-best-practices-implemented)
       - [**Image Size Optimization**](#image-size-optimization)
@@ -1024,16 +1029,40 @@ The project uses a **two-file dependency management strategy**:
 #### **Prerequisites**
 - Docker installed and running
 - Access to the project source code
+- Docker BuildKit for multi-architecture builds (enabled by default in recent Docker versions)
 
 #### **Build Command**
+
+**Single Architecture Build (Default):**
 ```bash
-# Build the optimized production image
-docker build -t mcp-instana .
+# Build for your local architecture (automatic detection)
+docker build -t mcp-instana:latest .
 
 # Build with a specific tag
 docker build -t mcp-instana:v1.0.0 .
 ```
 
+**Multi-Architecture Build:**
+```bash
+# Set up Docker BuildKit builder if you haven't already
+docker buildx create --name multiarch --driver docker-container --use
+
+# Build and push a multi-architecture image to a registry
+docker buildx build --platform linux/amd64,linux/arm64 -t username/mcp-instana:latest --push .
+```
+
+**Using the Helper Script:**
+```bash
+# Make the script executable
+chmod +x build_multiarch.sh
+
+# Build for local architecture
+./build_multiarch.sh
+
+# Build and push multi-architecture image
+./build_multiarch.sh --registry username/ --push
+```
+
 #### **What the Build Does**
 1. **Multi-stage build** for optimal size and security
 2. **Builder stage**: Installs only runtime dependencies from `pyproject-runtime.toml`
@@ -1045,27 +1074,14 @@ docker build -t mcp-instana:v1.0.0 .
 
 #### **Basic Usage**
 ```bash
-# Run with environment variables (recommended)
-docker run -p 8080:8080 \
-  -e INSTANA_API_TOKEN=your_instana_token \
-  -e INSTANA_BASE_URL=https://your-instana-instance.instana.io \
-  mcp-instana
+# Run the container (no credentials needed in the container)
+docker run -p 8080:8080 mcp-instana
 
 # Run with custom port
-docker run -p 8081:8080 \
-  -e INSTANA_API_TOKEN=your_instana_token \
-  -e INSTANA_BASE_URL=https://your-instana-instance.instana.io \
-  mcp-instana
+docker run -p 8081:8080 mcp-instana
 ```
 
-#### **Environment Variables**
-The container requires the following environment variables:
 
-| Variable | Description | Example |
-|----------|-------------|---------|
-| `INSTANA_API_TOKEN` | Your Instana API token | `your_instana_token` |
-| `INSTANA_BASE_URL` | Your Instana instance URL | `https://your-instana-instance.instana.io` |
-| `PORT` | Server port (optional, defaults to 8080) | `8080` |
 
 #### **Docker Compose Example**
 ```yaml
@@ -1075,9 +1091,6 @@ services:
     build: .
     ports:
       - "8080:8080"
-    environment:
-      - INSTANA_API_TOKEN=${INSTANA_API_TOKEN}
-      - INSTANA_BASE_URL=${INSTANA_BASE_URL}
     restart: unless-stopped
     healthcheck:
       test: ["CMD", "python", "-c", "import requests; requests.get('http://127.0.0.1:8080/health', timeout=5)"]
@@ -1087,15 +1100,35 @@ services:
       start_period: 40s
 ```
 
+### Multi-Architecture Support
+
+The Docker image supports multiple processor architectures, making it portable across different environments:
+
+#### **Supported Architectures**
+- ✅ **amd64/x86_64**: Standard Intel/AMD processors (Windows, Linux, most cloud VMs)
+- ✅ **arm64/aarch64**: Apple Silicon (M1/M2/M3), AWS Graviton, Raspberry Pi 4, etc.
+
+#### **Benefits of Multi-Architecture Images**
+- **Cross-Platform Compatibility**: Run the same image on any supported architecture
+- **Seamless Deployment**: No need to build different images for different environments
+- **CI/CD Simplification**: Build once, deploy anywhere
+- **Cloud Flexibility**: Switch between cloud providers and instance types without rebuilding images
+
+#### **How It Works**
+1. The multi-architecture image is a "manifest list" containing images for each architecture
+2. When you pull the image, Docker automatically selects the correct architecture for your system
+3. The image runs natively on your architecture without emulation, ensuring optimal performance
+
 ### Docker Security Features
 
 #### **Security Best Practices Implemented**
 - ✅ **Non-root user**: Container runs as `mcpuser` (not root)
-- ✅ **No hardcoded secrets**: All credentials passed via environment variables
+- ✅ **No secrets in container**: Credentials are passed via HTTP headers from clients, not stored in the container
 - ✅ **Minimal dependencies**: Only 20 essential runtime dependencies
 - ✅ **Multi-stage build**: Build tools don't make it to final image
 - ✅ **Health checks**: Built-in container health monitoring
 - ✅ **Optimized base image**: Uses `python:3.11-slim`
+- ✅ **Multi-architecture support**: Run natively on any supported platform
 
 #### **Image Size Optimization**
 - **Original approach**: 95+ dependencies → ~1-2GB+ image
@@ -1135,11 +1168,12 @@ docker exec -it <container_id> /bin/bash
 ### Production Deployment
 
 #### **Recommended Production Setup**
-1. **Use environment variables** for all secrets
-2. **Set up proper logging** and monitoring
-3. **Configure health checks** for container orchestration
-4. **Use container orchestration** (Kubernetes, Docker Swarm, etc.)
-5. **Implement proper backup** and disaster recovery
+1. **Run container without credentials** - The container runs in Streamable HTTP mode, so no Instana credentials are needed in the container
+2. **Configure clients with credentials** - Pass Instana credentials via HTTP headers from MCP clients (Claude Desktop, GitHub Copilot, etc.)
+3. **Set up proper logging** and monitoring
+4. **Configure health checks** for container orchestration
+5. **Use container orchestration** (Kubernetes, Docker Swarm, etc.)
+6. **Implement proper backup** and disaster recovery
 
 #### **Kubernetes Example**
 ```yaml
@@ -1162,14 +1196,6 @@ spec:
         image: mcp-instana:latest
         ports:
         - containerPort: 8080
-        env:
-        - name: INSTANA_API_TOKEN
-          valueFrom:
-            secretKeyRef:
-              name: instana-secrets
-              key: api-token
-        - name: INSTANA_BASE_URL
-          value: "https://your-instana-instance.instana.io"
         livenessProbe:
           httpGet:
             path: /health
@@ -1194,9 +1220,11 @@ spec:
 docker logs <container_id>
 
 # Common issues:
-# 1. Missing environment variables
-# 2. Port already in use
-# 3. Invalid Instana credentials
+# 1. Port already in use
+# 2. Invalid container image
+# 3. Missing dependencies
+
+# Credentials are passed via HTTP headers from the MCP client
 ```
 
 #### **Connection Issues**

{mcp_instana-0.3.0.dist-info → mcp_instana-0.3.1.dist-info}/RECORD

@@ -52,8 +52,8 @@ src/website/website_analyze.py,sha256=0VyK8f-9vW1LzZ70b7IxKzwqSL2bWw8wDFSOCx2pEr
 src/website/website_catalog.py,sha256=Z21urtdTf8sU2SZiCwGq5OyPLaswS9lw12TCD9pS__4,7127
 src/website/website_configuration.py,sha256=hBHSFgj6GXOfLvlq8p-tBU4KFQc99uS167DBz4cjjK0,35926
 src/website/website_metrics.py,sha256=6McxbVYZq5i61Ml3QcVeHS86y2rCIPzdDuUDOxNtnMM,10954
-mcp_instana-0.3.0.dist-info/METADATA,sha256=pBBWf3CzWNzeHE-5yRbEVJZ3ZV5EW2w34sVepEmiyjc,47089
-mcp_instana-0.3.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mcp_instana-0.3.0.dist-info/entry_points.txt,sha256=p1aZ9Ks0aJKpoIy6Mk-08cGYAfkXMNbwYIlokm513A4,140
-mcp_instana-0.3.0.dist-info/licenses/LICENSE.md,sha256=Ox7lseFP2kBRXBjsLweW1jLmWiCyrKjwF8ZUvCbKd70,11310
-mcp_instana-0.3.0.dist-info/RECORD,,
+mcp_instana-0.3.1.dist-info/METADATA,sha256=ihXkPTCUrBqJJ_hqtIBfi7rSfb-3xuEiQLn_-LhSwL8,48596
+mcp_instana-0.3.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mcp_instana-0.3.1.dist-info/entry_points.txt,sha256=p1aZ9Ks0aJKpoIy6Mk-08cGYAfkXMNbwYIlokm513A4,140
+mcp_instana-0.3.1.dist-info/licenses/LICENSE.md,sha256=Ox7lseFP2kBRXBjsLweW1jLmWiCyrKjwF8ZUvCbKd70,11310
+mcp_instana-0.3.1.dist-info/RECORD,,