mcp-instana 0.1.1__py3-none-any.whl → 0.2.1__py3-none-any.whl

{mcp_instana-0.1.1.dist-info → mcp_instana-0.2.1.dist-info}/METADATA

@@ -1,124 +1,24 @@
 Metadata-Version: 2.4
 Name: mcp-instana
-Version: 0.1.1
+Version: 0.2.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.11
-Requires-Dist: accelerate==1.6.0
-Requires-Dist: aiohappyeyeballs==2.6.1
-Requires-Dist: aiohttp==3.12.14
-Requires-Dist: aiosignal==1.4.0
-Requires-Dist: altair==5.5.0
-Requires-Dist: annotated-types==0.7.0
-Requires-Dist: anyio==4.9.0
-Requires-Dist: attrs==25.3.0
-Requires-Dist: blinker==1.9.0
-Requires-Dist: cachetools==5.5.2
-Requires-Dist: certifi==2025.1.31
-Requires-Dist: charset-normalizer==3.4.1
-Requires-Dist: click==8.1.8
-Requires-Dist: coverage>=7.10.1
-Requires-Dist: dataclasses-json==0.6.7
-Requires-Dist: fastapi==0.116.1
+Requires-Python: >=3.10
 Requires-Dist: fastmcp==2.10.3
-Requires-Dist: filelock==3.18.0
-Requires-Dist: frozenlist==1.5.0
-Requires-Dist: fsspec==2025.3.2
-Requires-Dist: gitdb==4.0.12
-Requires-Dist: gitpython==3.1.44
-Requires-Dist: h11==0.16.0
-Requires-Dist: httpcore==1.0.9
-Requires-Dist: httpx-sse==0.4.0
-Requires-Dist: httpx==0.28.1
-Requires-Dist: huggingface-hub==0.33.2
-Requires-Dist: ibm-cos-sdk-core==2.14.2
-Requires-Dist: ibm-cos-sdk-s3transfer==2.14.2
-Requires-Dist: ibm-cos-sdk==2.14.2
-Requires-Dist: ibm-watsonx-ai==1.3.26
-Requires-Dist: idna==3.10
 Requires-Dist: instana-client==1.0.0
-Requires-Dist: jinja2==3.1.6
-Requires-Dist: jmespath==1.0.1
-Requires-Dist: jsonpatch==1.33
-Requires-Dist: jsonpointer==3.0.0
-Requires-Dist: jsonschema-pydantic==0.6
-Requires-Dist: jsonschema-specifications==2024.10.1
-Requires-Dist: jsonschema==4.24.0
-Requires-Dist: langchain-community==0.3.21
-Requires-Dist: langchain-core==0.3.51
-Requires-Dist: langchain-ibm==0.3.13
-Requires-Dist: langchain-text-splitters==0.3.8
-Requires-Dist: langchain==0.3.23
-Requires-Dist: langsmith==0.3.30
-Requires-Dist: lomond==0.3.3
-Requires-Dist: markdown-it-py==3.0.0
-Requires-Dist: markupsafe==3.0.2
-Requires-Dist: marshmallow==3.26.1
-Requires-Dist: mcp==1.10.1
-Requires-Dist: mdurl==0.1.2
-Requires-Dist: mpmath==1.3.0
-Requires-Dist: multidict==6.4.3
-Requires-Dist: mypy-extensions==1.0.0
-Requires-Dist: narwhals==1.34.1
-Requires-Dist: nest-asyncio==1.6.0
-Requires-Dist: networkx==3.4.2
-Requires-Dist: numpy==2.2.4
-Requires-Dist: orjson==3.10.16
-Requires-Dist: packaging==24.2
-Requires-Dist: pandas==2.2.3
-Requires-Dist: propcache==0.3.1
-Requires-Dist: protobuf==5.29.5
-Requires-Dist: psutil==7.0.0
-Requires-Dist: pyarrow==19.0.1
-Requires-Dist: pydantic-core==2.33.2
-Requires-Dist: pydantic-settings==2.10.1
 Requires-Dist: pydantic==2.11.7
-Requires-Dist: pydeck==0.9.1
-Requires-Dist: pygments==2.19.1
-Requires-Dist: pytest-asyncio>=1.1.0
-Requires-Dist: pytest-cov>=6.2.1
-Requires-Dist: pytest-mock>=3.14.1
-Requires-Dist: pytest>=8.4.1
-Requires-Dist: python-dateutil==2.9.0.post0
 Requires-Dist: python-dotenv==1.1.0
-Requires-Dist: pytz==2025.2
-Requires-Dist: pyyaml==6.0.2
-Requires-Dist: referencing==0.36.2
-Requires-Dist: regex==2024.11.6
-Requires-Dist: requests-toolbelt==1.0.0
 Requires-Dist: requests==2.32.4
-Requires-Dist: rich==14.0.0
-Requires-Dist: rpds-py==0.24.0
-Requires-Dist: ruff==0.5.0
-Requires-Dist: safetensors==0.5.3
-Requires-Dist: shellingham==1.5.4
-Requires-Dist: six==1.17.0
-Requires-Dist: smmap==5.0.2
-Requires-Dist: sniffio==1.3.1
-Requires-Dist: sqlalchemy==2.0.40
-Requires-Dist: sse-starlette==2.2.1
-Requires-Dist: starlette==0.47.2
-Requires-Dist: streamlit==1.44.1
-Requires-Dist: sympy==1.13.1
-Requires-Dist: tabulate==0.9.0
-Requires-Dist: tenacity==9.1.2
-Requires-Dist: tokenizers==0.21.1
-Requires-Dist: toml==0.10.2
-Requires-Dist: tornado==6.5
-Requires-Dist: tqdm==4.67.1
-Requires-Dist: transformers==4.53.1
-Requires-Dist: typer==0.15.2
-Requires-Dist: typing-extensions==4.13.2
-Requires-Dist: typing-inspect==0.9.0
-Requires-Dist: typing-inspection==0.4.0
-Requires-Dist: tzdata==2025.2
-Requires-Dist: urllib3==2.5.0
-Requires-Dist: uv==0.8.6
-Requires-Dist: uvicorn==0.35.0
-Requires-Dist: yarl==1.19.0
-Requires-Dist: zstandard==0.23.0
+Provides-Extra: dev
+Requires-Dist: coverage>=7.10.1; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.1.0; extra == 'dev'
+Requires-Dist: pytest-cov>=6.2.1; extra == 'dev'
+Requires-Dist: pytest-mock>=3.14.1; extra == 'dev'
+Requires-Dist: pytest>=8.4.1; extra == 'dev'
+Requires-Dist: ruff==0.5.0; extra == 'dev'
+Requires-Dist: uv==0.8.6; extra == 'dev'
 Description-Content-Type: text/markdown
 
 <!-- START doctoc generated TOC please keep comment here to allow auto update -->
@@ -129,14 +29,24 @@ Description-Content-Type: text/markdown
   - [Architecture Overview](#architecture-overview)
   - [Workflow](#workflow)
   - [Prerequisites](#prerequisites)
-    - [Installing uv](#installing-uv)
-    - [Setting Up the Environment](#setting-up-the-environment)
+    - [Option 1: Install from PyPI (Recommended)](#option-1-install-from-pypi-recommended)
+    - [Option 2: Development Installation](#option-2-development-installation)
+      - [Installing uv](#installing-uv)
+      - [Setting Up the Environment](#setting-up-the-environment)
     - [Header-Based Authentication for Streamable HTTP Mode](#header-based-authentication-for-streamable-http-mode)
   - [Starting the Local MCP Server](#starting-the-local-mcp-server)
     - [Server Command Options](#server-command-options)
+      - [Using the CLI (PyPI Installation)](#using-the-cli-pypi-installation)
+      - [Using Development Installation](#using-development-installation)
     - [Starting in Streamable HTTP Mode](#starting-in-streamable-http-mode)
+      - [Using CLI (PyPI Installation)](#using-cli-pypi-installation)
+      - [Using Development Installation](#using-development-installation-1)
     - [Starting in Stdio Mode](#starting-in-stdio-mode)
+      - [Using CLI (PyPI Installation)](#using-cli-pypi-installation-1)
+      - [Using Development Installation](#using-development-installation-2)
     - [Tool Categories](#tool-categories)
+      - [Using CLI (PyPI Installation)](#using-cli-pypi-installation-2)
+      - [Using Development Installation](#using-development-installation-3)
     - [Verifying Server Status](#verifying-server-status)
     - [Common Startup Issues](#common-startup-issues)
   - [Setup and Usage](#setup-and-usage)
@@ -151,9 +61,38 @@ Description-Content-Type: text/markdown
   - [Tool Filtering](#tool-filtering)
     - [Available Tool Categories](#available-tool-categories)
     - [Usage Examples](#usage-examples)
+      - [Using CLI (PyPI Installation)](#using-cli-pypi-installation-3)
+      - [Using Development Installation](#using-development-installation-4)
     - [Benefits of Tool Filtering](#benefits-of-tool-filtering)
   - [Example Prompts](#example-prompts)
+  - [Docker Deployment](#docker-deployment)
+    - [Docker Architecture](#docker-architecture)
+      - [**pyproject.toml** (Development)](#pyprojecttoml-development)
+      - [**pyproject-runtime.toml** (Production)](#pyproject-runtimetoml-production)
+    - [Building the Docker Image](#building-the-docker-image)
+      - [**Prerequisites**](#prerequisites-1)
+      - [**Build Command**](#build-command)
+      - [**What the Build Does**](#what-the-build-does)
+    - [Running the Docker Container](#running-the-docker-container)
+      - [**Basic Usage**](#basic-usage)
+      - [**Environment Variables**](#environment-variables)
+      - [**Docker Compose Example**](#docker-compose-example)
+    - [Docker Security Features](#docker-security-features)
+      - [**Security Best Practices Implemented**](#security-best-practices-implemented)
+      - [**Image Size Optimization**](#image-size-optimization)
+    - [Testing the Docker Container](#testing-the-docker-container)
+      - [**Health Check**](#health-check)
+      - [**MCP Inspector Testing**](#mcp-inspector-testing)
+      - [**Logs and Debugging**](#logs-and-debugging)
+    - [Production Deployment](#production-deployment)
+      - [**Recommended Production Setup**](#recommended-production-setup)
+      - [**Kubernetes Example**](#kubernetes-example)
   - [Troubleshooting](#troubleshooting)
+    - [**Docker Issues**](#docker-issues)
+      - [**Container Won't Start**](#container-wont-start)
+      - [**Connection Issues**](#connection-issues)
+      - [**Performance Issues**](#performance-issues)
+    - [**General Issues**](#general-issues)
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
@@ -234,7 +173,21 @@ sequenceDiagram
 
 ## Prerequisites
 
-### Installing uv
+### Option 1: Install from PyPI (Recommended)
+
+The easiest way to use mcp-instana is to install it directly from PyPI:
+
+```shell
+pip install mcp-instana
+```
+
+After installation, you can run the server using the `mcp-instana` command directly.
+
+### Option 2: Development Installation
+
+For development or local customization, you can clone and set up the project locally.
+
+#### Installing uv
 
 This project uses `uv`, a fast Python package installer and resolver. To install `uv`, you have several options:
 
@@ -250,7 +203,7 @@ brew install uv
 
 For more installation options and detailed instructions, visit the [uv documentation](https://github.com/astral-sh/uv).
 
-### Setting Up the Environment
+#### Setting Up the Environment
 
 After installing `uv`, set up the project environment by running:
 
@@ -282,7 +235,17 @@ Before configuring any MCP client (Claude Desktop, GitHub Copilot, or custom MCP
 
 ### Server Command Options
 
-The MCP server (`src/core/server.py`) supports the following command-line options:
+#### Using the CLI (PyPI Installation)
+
+If you installed mcp-instana from PyPI, use the `mcp-instana` command:
+
+```bash
+mcp-instana [OPTIONS]
+```
+
+#### Using Development Installation
+
+For local development, use the `uv run` command:
 
 ```bash
 uv run src/core/server.py [OPTIONS]
@@ -292,14 +255,35 @@ uv run src/core/server.py [OPTIONS]
 - `--transport <mode>`: Transport mode (choices: `streamable-http`, `stdio`)
 - `--debug`: Enable debug mode with additional logging
 - `--log-level <level>`: Set the logging level (choices: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`)
-- `--tools <categories>`: Comma-separated list of tool categories to enable (e.g., `infra,app,events`)
+- `--tools <categories>`: Comma-separated list of tool categories to enable (e.g., infra,app,events,automation,website). Enabling a category will also enable its related prompts. For example: `--tools infra` enables the infra tools and all infra-related prompts.
 - `--list-tools`: List all available tool categories and exit
-- `--port <port>`: Port to listen on (default: 8000)
+- `--port <port>`: Port to listen on (default: 8080)
 - `--help`: Show help message and exit
 
 ### Starting in Streamable HTTP Mode
 
-**Streamable HTTP mode** provides a REST API interface and is recommended for most use cases:
+**Streamable HTTP mode** provides a REST API interface and is recommended for most use cases.
+
+#### Using CLI (PyPI Installation)
+
+```bash
+# Start with all tools enabled (default)
+mcp-instana --transport streamable-http
+
+# Start with debug logging
+mcp-instana --transport streamable-http --debug
+
+# Start with a specific log level
+mcp-instana --transport streamable-http --log-level WARNING
+
+# Start with specific tool categories only
+mcp-instana --transport streamable-http --tools infra,events
+
+# Combine options (specific log level, custom tools)
+mcp-instana --transport streamable-http --log-level DEBUG --tools app,events
+```
+
+#### Using Development Installation
 
 ```bash
 # Start with all tools enabled (default)
@@ -311,10 +295,10 @@ uv run src/core/server.py --transport streamable-http --debug
 # Start with a specific log level
 uv run src/core/server.py --transport streamable-http --log-level WARNING
 
-# Start with specific tool categories only
+# Start with specific tool and prompts categories only
 uv run src/core/server.py --transport streamable-http --tools infra,events
 
-# Combine options (specific log level, custom tools)
+# Combine options (specific log level, custom tools and prompts)
 uv run src/core/server.py --transport streamable-http --log-level DEBUG --tools app,events
 ```
 
@@ -322,12 +306,28 @@ uv run src/core/server.py --transport streamable-http --log-level DEBUG --tools
 - Uses HTTP headers for authentication (no environment variables needed)
 - Supports different credentials per request
 - Better suited for shared environments
-- Default port: 8000
-- Endpoint: `http://0.0.0.0:8000/mcp/`
+- Default port: 8080
+- Endpoint: `http://0.0.0.0:8080/mcp/`
 
 ### Starting in Stdio Mode
 
-**Stdio mode** uses standard input/output for communication and requires environment variables for authentication:
+**Stdio mode** uses standard input/output for communication and requires environment variables for authentication.
+
+#### Using CLI (PyPI Installation)
+
+```bash
+# Set environment variables first
+export INSTANA_BASE_URL="https://your-instana-instance.instana.io"
+export INSTANA_API_TOKEN="your_instana_api_token"
+
+# Start the server (stdio is the default if no transport specified)
+mcp-instana
+
+# Or explicitly specify stdio mode
+mcp-instana --transport stdio
+```
+
+#### Using Development Installation
 
 ```bash
 # Set environment variables first
@@ -348,7 +348,20 @@ uv run src/core/server.py --transport stdio
 
 ### Tool Categories
 
-You can optimize server performance by enabling only the tool categories you need:
+You can optimize server performance by enabling only the tools and prompts categories you need:
+
+#### Using CLI (PyPI Installation)
+
+```bash
+# List all available categories
+mcp-instana --list-tools
+
+# Enable specific categories
+mcp-instana --transport streamable-http --tools infra,app
+mcp-instana --transport streamable-http --tools events
+```
+
+#### Using Development Installation
 
 ```bash
 # List all available categories
@@ -360,9 +373,11 @@ uv run src/core/server.py --transport streamable-http --tools events
 ```
 
 **Available Categories:**
-- **`infra`**: Infrastructure monitoring tools (resources, catalog, topology, analyze, metrics)
-- **`app`**: Application performance tools (resources, metrics, alerts, catalog, topology, analyze)
-- **`events`**: Event monitoring tools (Kubernetes events, agent monitoring)
+- **`infra`**: Infrastructure monitoring tools and prompts (resources, catalog, topology, analyze, metrics)
+- **`app`**: Application performance tools and prompts (resources, metrics, alerts, catalog, topology, analyze, settings, global alerts)
+- **`events`**: Event monitoring tools and prompts (Kubernetes events, agent monitoring)
+- **`automation`**: Automation-related tools and prompts (action catalog, action history)
+- **`website`**: Website monitoring tools and prompts (metrics, catalog, analyze, configuration)
 
 ### Verifying Server Status
 
@@ -371,7 +386,7 @@ Once started, you can verify the server is running:
 **For Streamable HTTP mode:**
 ```bash
 # Check server health
-curl http://0.0.0.0:8000/mcp/
+curl http://0.0.0.0:8080/mcp/
 
 # Or with custom port
 curl http://0.0.0.0:9000/mcp/
@@ -390,7 +405,7 @@ If you encounter SSL certificate errors, ensure your Python environment has acce
 ```
 
 **Port Already in Use:**
-If port 8000 is already in use, specify a different port:
+If port 8080 is already in use, specify a different port:
 ```bash
 uv run src/core/server.py --transport streamable-http --port 9000
 ```
@@ -431,7 +446,8 @@ Configure Claude Desktop to pass Instana credentials via headers:
     "Instana MCP Server": {
       "command": "npx",
       "args": [
-         "mcp-remote", "http://0.0.0.0:8000/mcp/",
+        "mcp-remote", "http://0.0.0.0:8080/mcp/",
+        "--allow-http",
         "--header", "instana-base-url: https://your-instana-instance.instana.io",
         "--header", "instana-api-token: your_instana_api_token"
       ]
@@ -458,7 +474,26 @@ get me all endpoints from Instana
 
 #### Stdio Mode
 
-**Configuration:**
+**Configuration using CLI (PyPI Installation - Recommended):**
+
+```json
+{
+  "mcpServers": {
+    "Instana MCP Server": {
+      "command": "mcp-instana",
+      "args": ["--transport", "stdio"],
+      "env": {
+        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
+        "INSTANA_API_TOKEN": "your_instana_api_token"
+      }
+    }
+  }
+}
+```
+
+**Note:** If you encounter "command not found" errors, use the full path to mcp-instana. Find it with `which mcp-instana` and use that path instead.
+
+**Configuration using Development Installation:**
 
 ```json
 {
@@ -503,7 +538,8 @@ You can directly create or update `.vscode/mcp.json` with the following configur
     "Instana MCP Server": {
       "command": "npx",
       "args": [
-        "mcp-remote", "http://0.0.0.0:8000/mcp/",
+        "mcp-remote", "http://0.0.0.0:8080/mcp/",
+        "--allow-http",
         "--header", "instana-base-url: https://your-instana-instance.instana.io",
         "--header", "instana-api-token: your_instana_api_token"
       ],
@@ -527,6 +563,27 @@ You can directly create or update `.vscode/mcp.json` with the following configur
 
 **Step 1: Create VS Code MCP Configuration**
 
+**Using CLI (PyPI Installation - Recommended):**
+
+Create `.vscode/mcp.json` in your project root:
+
+```json:.vscode/mcp.json
+{
+  "servers": {
+    "Instana MCP Server": {
+      "command": "mcp-instana",
+      "args": ["--transport", "stdio"],
+      "env": {
+        "INSTANA_BASE_URL": "https://your-instana-instance.instana.io",
+        "INSTANA_API_TOKEN": "your_instana_api_token"
+      }
+    }
+  }
+}
+```
+
+**Using Development Installation:**
+
 Create `.vscode/mcp.json` in your project root:
 
 ```json:.vscode/mcp.json
@@ -550,8 +607,10 @@ Create `.vscode/mcp.json` in your project root:
 ```
 
 **Note:** Replace the following values with your actual configuration:
-- `command`: Update the uv path to match your system's uv installation (e.g., `/path/to/your/uv/bin/uv` or `/usr/local/bin/uv`)
-- `--directory`: Update with the absolute path to your mcp-instana project directory
+- For CLI installation: Ensure `mcp-instana` is in your PATH
+- For development installation: 
+  - `command`: Update the uv path to match your system's uv installation (e.g., `/path/to/your/uv/bin/uv` or `/usr/local/bin/uv`)
+  - `--directory`: Update with the absolute path to your mcp-instana project directory
 - `INSTANA_BASE_URL`: Your Instana instance URL
 - `INSTANA_API_TOKEN`: Your Instana API token
 
@@ -617,12 +676,15 @@ Here is an example of a GitHub Copilot response:
   - [x] Infrastructure Topology
     - [x] Get Hosts for Snapshot
     - [x] Get Topology
-  - [ ] Events
-    - [ ] Events
-      - [ ] Get all Events
+  - [x] Events
+    - [x] Events
+      - [x] Get Event
       - [x] Get Events by IDs
       - [x] Get Agent Monitoring Events
       - [x] Get Kubernetes Info Events
+      - [x] Get Issues
+      - [x] Get Incidents
+      - [x] Get Changes
 
 ## Available Tools
 
@@ -665,9 +727,14 @@ Here is an example of a GitHub Copilot response:
 | `enable_application_alert_config`                             | Application Alert Configuration| Enable Application Alert Config                        |
 | `disable_application_alert_config`                            | Application Alert Configuration| Disable Smart Alert Config                             |
 | `restore_application_alert_config`                            | Application Alert Configuration| Restore Smart Alert Config                             |
-| `get_event`                                                   | Events                         | Get Events by IDs                                      |
+| `get_event`                                                   | Events                         | Get Specific Event by ID                               |
 | `get_kubernetes_info_events`                                  | Events                         | Get Kubernetes Info Events                             |
 | `get_agent_monitoring_events`                                 | Events                         | Get Agent Monitoring Events                            |
+| `get_issues`                                                  | Events                         | Get Issues                                             |
+| `get_incidents`                                               | Events                         | Get Incidents                                          |
+| `get_changes`                                                 | Events                         | Get Changes                                            |
+| `get_events_by_ids`                                           | Events                         | Get Events by IDs                                      |
+
 
 ## Tool Filtering
 
@@ -689,12 +756,45 @@ The MCP server supports selective tool loading to optimize performance and reduc
   - Application Catalog: Metadata and definitions
   - Application Topology: Service dependency mapping
   - Application Analyze: Application performance analysis
+  - Application Settings: Configuration management
+  - Application Global Alert: Global alert management
 
 - **`events`**: Event monitoring tools
-  - Events: Kubernetes events, agent monitoring, and system event tracking
+  - Events: Kubernetes events, agent monitoring, incidents, issues, changes and system event tracking
+
+- **`automation`**: Automation-related tools
+  - Action Catalog: Automation action discovery and management
+  - Action History: Tracking and managing automation action history
+
+- **`website`**: Website monitoring tools
+  - Website Metrics: Performance measurement for websites
+  - Website Catalog: Website metadata and definitions
+  - Website Analyze: Website performance analysis
+  - Website Configuration: Website configuration management
 
 ### Usage Examples
 
+#### Using CLI (PyPI Installation)
+
+```bash
+# Enable only infrastructure and events tools
+mcp-instana --tools infra,events --transport streamable-http
+
+# Enable only application tools
+mcp-instana --tools app --transport streamable-http
+
+# Enable automation and website tools
+mcp-instana --tools automation,website --transport streamable-http
+
+# Enable all tools (default behavior)
+mcp-instana --transport streamable-http
+
+# List all available tool categories and their tools
+mcp-instana --list-tools
+```
+
+#### Using Development Installation
+
 ```bash
 # Enable only infrastructure and events tools
 uv run src/core/server.py --tools infra,events --transport streamable-http
@@ -702,6 +802,9 @@ uv run src/core/server.py --tools infra,events --transport streamable-http
 # Enable only application tools
 uv run src/core/server.py --tools app --transport streamable-http
 
+# Enable automation and website tools
+uv run src/core/server.py --tools automation,website --transport streamable-http
+
 # Enable all tools (default behavior)
 uv run src/core/server.py --transport streamable-http
 
@@ -895,8 +998,226 @@ The azureManagedHSM plugin provides three metrics that can help monitor service
 3. Overall Service Availability: This metric measures the availability of the service.
 ```
 
+## Docker Deployment
+
+The MCP Instana server can be deployed using Docker for production environments. The Docker setup is optimized for security, performance, and minimal resource usage.
+
+### Docker Architecture
+
+The project uses a **two-file dependency management strategy**:
+
+#### **pyproject.toml** (Development)
+- **Purpose**: Full development environment with all tools
+- **Dependencies**: 20 essential + 8 development dependencies (pytest, ruff, coverage, etc.)
+- **Usage**: Local development, testing, and CI/CD
+- **Size**: Larger but includes all development tools
+
+#### **pyproject-runtime.toml** (Production)
+- **Purpose**: Minimal production runtime dependencies only
+- **Dependencies**: 20 essential dependencies only
+- **Usage**: Docker production builds
+- **Size**: Optimized for minimal image size and security
+
+### Building the Docker Image
+
+#### **Prerequisites**
+- Docker installed and running
+- Access to the project source code
+
+#### **Build Command**
+```bash
+# Build the optimized production image
+docker build -t mcp-instana .
+
+# Build with a specific tag
+docker build -t mcp-instana:v1.0.0 .
+```
+
+#### **What the Build Does**
+1. **Multi-stage build** for optimal size and security
+2. **Builder stage**: Installs only runtime dependencies from `pyproject-runtime.toml`
+3. **Runtime stage**: Creates minimal production image with non-root user
+4. **Security**: No hardcoded secrets, proper user permissions
+5. **Optimization**: Only essential dependencies (20 vs 95+ in development)
+
+### Running the Docker Container
+
+#### **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 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
+```
+
+#### **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
+version: '3.8'
+services:
+  mcp-instana:
+    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)"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+```
+
+### 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
+- ✅ **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`
+
+#### **Image Size Optimization**
+- **Original approach**: 95+ dependencies → ~1-2GB+ image
+- **Optimized approach**: 20 dependencies → ~266MB image
+- **Size reduction**: ~70-80% smaller images
+- **Benefits**: Faster deployments, lower storage costs, reduced attack surface
+
+### Testing the Docker Container
+
+#### **Health Check**
+```bash
+# Check if container is healthy
+docker ps
+
+# Test the MCP endpoint
+curl http://localhost:8080/mcp/
+```
+
+#### **MCP Inspector Testing**
+```bash
+# Test with MCP Inspector
+npx @modelcontextprotocol/inspector http://localhost:8080/mcp/
+```
+
+#### **Logs and Debugging**
+```bash
+# View container logs
+docker logs <container_id>
+
+# Follow logs in real-time
+docker logs -f <container_id>
+
+# Execute commands in running container
+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
+
+#### **Kubernetes Example**
+```yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: mcp-instana
+spec:
+  replicas: 2
+  selector:
+    matchLabels:
+      app: mcp-instana
+  template:
+    metadata:
+      labels:
+        app: mcp-instana
+    spec:
+      containers:
+      - name: mcp-instana
+        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
+            port: 8080
+          initialDelaySeconds: 30
+          periodSeconds: 10
+        readinessProbe:
+          httpGet:
+            path: /health
+            port: 8080
+          initialDelaySeconds: 5
+          periodSeconds: 5
+```
+
 ## Troubleshooting
 
+### **Docker Issues**
+
+#### **Container Won't Start**
+```bash
+# Check container logs
+docker logs <container_id>
+
+# Common issues:
+# 1. Missing environment variables
+# 2. Port already in use
+# 3. Invalid Instana credentials
+```
+
+#### **Connection Issues**
+```bash
+# Test container connectivity
+docker exec -it <container_id> curl http://127.0.0.1:8080/health
+
+# Check port mapping
+docker port <container_id>
+```
+
+#### **Performance Issues**
+```bash
+# Check container resource usage
+docker stats <container_id>
+
+# Monitor container health
+docker inspect <container_id> | grep -A 10 Health
+```
+
+### **General Issues**
+
 - **GitHub Copilot**
   - If you encounter issues with GitHub Copilot, try starting/stopping/restarting the server in the `mcp.json` file and keep only one server running at a time.