mcp-instana 0.3.0__tar.gz → 0.3.1__tar.gz

mcp_instana-0.3.1/.github/workflows/build-multiplatform.yml

@@ -0,0 +1,37 @@
+name: Build Multi-Platform Linux Container
+
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Image tag'
+        required: true
+        default: 'latest'
+
+jobs:
+  build-linux:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v2
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v2
+
+      - name: Login to DockerHub
+        uses: docker/login-action@v2
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Build and push Linux images
+        uses: docker/build-push-action@v4
+        with:
+          context: .
+          file: ./Dockerfile
+          platforms: linux/amd64,linux/arm64,linux/arm/v7,linux/386,linux/ppc64le,linux/s390x
+          push: true
+          tags: jaysharma3/mcp-instana:${{ github.event.inputs.tag }}

mcp_instana-0.3.1/.github/workflows/build-windows-container.yml

@@ -0,0 +1,52 @@
+name: Build Multi-Platform Container
+
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Image tag'
+        required: true
+        default: 'latest'
+
+jobs:
+  build:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v2
+
+      - name: Login to DockerHub
+        uses: docker/login-action@v2
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Build and push Windows image
+        uses: docker/build-push-action@v4
+        with:
+          context: .
+          file: ./Dockerfile.windows
+          platforms: windows/amd64
+          push: true
+          tags: jaysharma3/mcp-instana:${{ github.event.inputs.tag }}-windows
+
+      - name: Create and push manifest
+        if: success()
+        shell: bash
+        run: |
+          # Pull the Linux image to check if it exists
+          if docker manifest inspect jaysharma3/mcp-instana:${{ github.event.inputs.tag }}-linux > /dev/null 2>&1; then
+            echo "Creating manifest with both Linux and Windows images"
+            docker manifest create jaysharma3/mcp-instana:${{ github.event.inputs.tag }} \
+              jaysharma3/mcp-instana:${{ github.event.inputs.tag }}-linux \
+              jaysharma3/mcp-instana:${{ github.event.inputs.tag }}-windows
+            docker manifest push jaysharma3/mcp-instana:${{ github.event.inputs.tag }}
+          else
+            echo "Linux image not found. Creating manifest with Windows image only"
+            docker manifest create jaysharma3/mcp-instana:${{ github.event.inputs.tag }}-windows-only \
+              jaysharma3/mcp-instana:${{ github.event.inputs.tag }}-windows
+            docker manifest push jaysharma3/mcp-instana:${{ github.event.inputs.tag }}-windows-only
+          fi

mcp_instana-0.3.1/Dockerfile

@@ -0,0 +1,119 @@
+# Multi-platform Linux Dockerfile
+#
+# This Dockerfile supports multiple Linux platforms:
+# - Linux AMD64 (x86_64): Standard Intel/AMD processors on Linux
+# - Linux ARM64 (aarch64): Apple Silicon, AWS Graviton, Raspberry Pi 4
+# - Linux ARM/v7: Older ARM devices like Raspberry Pi 2/3
+# - Linux 386: 32-bit x86 systems
+# - Linux PPC64LE: PowerPC 64-bit Little Endian
+# - Linux s390x: IBM Z mainframes
+#
+# To create a multi-architecture image that works on any platform:
+#
+# 1. Set up Docker BuildKit builder if you haven't already:
+#    docker buildx create --name multiarch --driver docker-container --use
+#
+# 2. Build and push a multi-architecture image to a registry:
+#    docker buildx build --platform linux/amd64,linux/arm64 -t username/mcp-instana:latest --push .
+#
+# 3. Pull and run the image on any platform:
+#    docker pull username/mcp-instana:latest
+#    docker run -p 8080:8080 username/mcp-instana:latest
+#
+# The image will automatically use the correct architecture version for the host system.
+#
+# Note: The --push flag is required for multi-architecture builds as Docker needs to
+# create a manifest list in a registry. If you want to load the image locally for testing,
+# you can only build for your current architecture:
+#    docker buildx build --platform linux/amd64 -t mcp-instana:latest --load .
+#
+# For CI/CD pipelines (e.g., GitHub Actions):
+# ```yaml
+# jobs:
+#   build-push:
+#     runs-on: ubuntu-latest
+#     steps:
+#       - name: Checkout code
+#         uses: actions/checkout@v3
+#       
+#       - name: Set up QEMU
+#         uses: docker/setup-qemu-action@v2
+#       
+#       - name: Set up Docker Buildx
+#         uses: docker/setup-buildx-action@v2
+#       
+#       - name: Login to DockerHub
+#         uses: docker/login-action@v2
+#         with:
+#           username: ${{ secrets.DOCKERHUB_USERNAME }}
+#           password: ${{ secrets.DOCKERHUB_TOKEN }}
+#       
+#       - name: Build and push
+#         uses: docker/build-push-action@v4
+#         with:
+#           context: .
+#           platforms: linux/amd64,linux/arm64
+#           push: true
+#           tags: username/mcp-instana:latest
+# ```
+#
+# Stage 1: Build stage with minimal runtime dependencies
+FROM --platform=${BUILDPLATFORM:-linux/arm64} docker.io/library/python:3.11-slim AS builder
+
+# Install system dependencies needed for building
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gcc \
+    g++ \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set working directory
+WORKDIR /app
+
+# Copy only the runtime dependency file and source code needed for the build
+COPY pyproject-runtime.toml pyproject.toml
+COPY src ./src
+COPY README.md ./
+
+# Install uv for dependency management
+RUN pip install --no-cache-dir uv
+
+# Install only runtime dependencies using the minimal pyproject-runtime.toml
+RUN uv pip install --no-cache-dir --system .
+
+# Stage 2: Runtime stage
+FROM python:3.11-slim AS runtime
+
+# Set working directory
+WORKDIR /app
+
+# Create a non-root user for security
+RUN groupadd -r mcpuser && useradd -r -g mcpuser mcpuser
+
+# Copy only the Python packages from builder (no source code needed)
+COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
+COPY --from=builder /usr/local/bin /usr/local/bin
+
+# Copy only the source code needed for runtime
+COPY src ./src
+
+# Set ownership to non-root user
+RUN chown -R mcpuser:mcpuser /app
+
+# Switch to non-root user
+USER mcpuser
+
+# Expose the default port (configurable via PORT env var)
+EXPOSE 8080
+
+# Set environment variables (no hardcoded secrets)
+ENV PYTHONPATH=/app
+ENV PYTHONUNBUFFERED=1
+ENV PORT=8080
+
+# Health check using container's internal network
+HEALTHCHECK --interval=30s --timeout=30s --start-period=5s --retries=3 \
+    CMD python -c "import requests; requests.get('http://127.0.0.1:8080/health', timeout=5)" || exit 1
+
+# Run the server
+ENTRYPOINT ["python", "-m", "src.core.server"]
+CMD ["--transport", "streamable-http"]

{mcp_instana-0.3.0 → mcp_instana-0.3.1}/PKG-INFO

@@ -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 → mcp_instana-0.3.1}/README.md

@@ -1,5 +1,6 @@
 <!-- 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)
@@ -54,6 +55,10 @@
       - [**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)
@@ -1000,16 +1005,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`
@@ -1021,27 +1050,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
@@ -1051,9 +1067,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)"]
@@ -1063,15 +1076,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
@@ -1111,11 +1144,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
@@ -1138,14 +1172,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
@@ -1170,9 +1196,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**