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

{mcp_instana-0.2.1 → mcp_instana-0.3.0}/.gitignore

@@ -178,3 +178,4 @@ cython_debug/
 # Ignore tooling dirs
 .Bob/
 .vscode/
+mcp-instana.mcpb

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-instana
-Version: 0.2.1
+Version: 0.3.0
 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
@@ -8,6 +8,7 @@ License-File: LICENSE.md
 Requires-Python: >=3.10
 Requires-Dist: fastmcp==2.10.3
 Requires-Dist: instana-client==1.0.0
+Requires-Dist: mcp
 Requires-Dist: pydantic==2.11.7
 Requires-Dist: python-dotenv==1.1.0
 Requires-Dist: requests==2.32.4

mcp_instana-0.3.0/conftest.py

@@ -0,0 +1,4 @@
+"""
+Top-level pytest configuration
+"""
+pytest_plugins = ["pytest_asyncio"]

mcp_instana-0.3.0/docs/PRIVACY.md

@@ -0,0 +1,31 @@
+# Privacy Policy
+
+Last updated: 2025-09-26
+
+## Overview
+
+This application is designed with privacy in mind. We do not collect, transmit, or store any personal information outside your device. All functionality is executed locally.
+
+## Data Handling
+
+- **Data Collection**: We do not collect any personal or usage data.
+
+- **Data Storage**: No data is stored outside of your local environment.
+
+- **Data Transmission**: No information is sent to external servers or third parties.
+
+## Local Execution
+
+All execution happens **entirely on your device**. The application operates without relying on remote services or external APIs.
+
+## Third Parties
+
+We do not share any information with third parties, as no data ever leaves your system.
+
+## Changes to This Policy
+
+We may update this privacy policy from time to time. Any changes will be clearly indicated in the version linked from the manifest.
+
+## Contact
+
+If you have any questions about this Privacy Policy, please contact the MCP Instana Team via mcp-instana@ibm.com.

mcp_instana-0.3.0/docs/assets/.gitattributes

@@ -0,0 +1 @@
+*.png filter=lfs diff=lfs merge=lfs -text

mcp_instana-0.3.0/docs/assets/instana.svg

@@ -0,0 +1,15 @@
+<svg id="Ibm-Instana--Streamline-Carbon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" height="16" width="16">
+  <desc>
+    Ibm Instana Streamline Icon: https://streamlinehq.com
+  </desc>
+  <defs></defs>
+  <path d="M4.5 6.5h1v3H4.5Z" fill="#000000" stroke-width="0.5"></path>
+  <path d="M10.5 6.5h1v3h-1Z" fill="#000000" stroke-width="0.5"></path>
+  <path d="M6.5 5.5h1v6.5h-1Z" fill="#000000" stroke-width="0.5"></path>
+  <path d="M8.5 4.5h1v6.5h-1Z" fill="#000000" stroke-width="0.5"></path>
+  <path d="M10 2.5a1 1 0 1 0 2 0 1 1 0 1 0 -2 0" fill="#000000" stroke-width="0.5"></path>
+  <path d="M4 13.5a1 1 0 1 0 2 0 1 1 0 1 0 -2 0" fill="#000000" stroke-width="0.5"></path>
+  <path d="M11.0458 14H7v-1h4.0458l2.9541 -5 -1.3496 -2.28395 0.86135 -0.5088 1.3496 2.28395c0.18505 0.3137 0.18505 0.70385 0 1.0176l-2.9546 5c-0.1787 0.30275 -0.5088 0.4912 -0.86085 0.4912Z" fill="#000000" stroke-width="0.5"></path>
+  <path d="m2.4884 10.79295 -1.3496 -2.2842c-0.18505 -0.3137 -0.18505 -0.70385 0 -1.0176l2.9546 -5c0.1792 -0.303 0.5088 -0.4912 0.86085 -0.4912h4.0458v1H4.95425l-2.9541 5 1.3496 2.2842 -0.86135 0.5088Z" fill="#000000" stroke-width="0.5"></path>
+  <path id="_Transparent_Rectangle_" d="M0 0h16v16H0Z" fill="none" stroke-width="0.5"></path>
+</svg>

mcp_instana-0.3.0/mcpb/.mcpbignore

@@ -0,0 +1,2 @@
+pack.sh
+**.DS_Store

mcp_instana-0.3.0/mcpb/assets/instana.svg

@@ -0,0 +1,15 @@
+<svg id="Ibm-Instana--Streamline-Carbon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" height="16" width="16">
+  <desc>
+    Ibm Instana Streamline Icon: https://streamlinehq.com
+  </desc>
+  <defs></defs>
+  <path d="M4.5 6.5h1v3H4.5Z" fill="#000000" stroke-width="0.5"></path>
+  <path d="M10.5 6.5h1v3h-1Z" fill="#000000" stroke-width="0.5"></path>
+  <path d="M6.5 5.5h1v6.5h-1Z" fill="#000000" stroke-width="0.5"></path>
+  <path d="M8.5 4.5h1v6.5h-1Z" fill="#000000" stroke-width="0.5"></path>
+  <path d="M10 2.5a1 1 0 1 0 2 0 1 1 0 1 0 -2 0" fill="#000000" stroke-width="0.5"></path>
+  <path d="M4 13.5a1 1 0 1 0 2 0 1 1 0 1 0 -2 0" fill="#000000" stroke-width="0.5"></path>
+  <path d="M11.0458 14H7v-1h4.0458l2.9541 -5 -1.3496 -2.28395 0.86135 -0.5088 1.3496 2.28395c0.18505 0.3137 0.18505 0.70385 0 1.0176l-2.9546 5c-0.1787 0.30275 -0.5088 0.4912 -0.86085 0.4912Z" fill="#000000" stroke-width="0.5"></path>
+  <path d="m2.4884 10.79295 -1.3496 -2.2842c-0.18505 -0.3137 -0.18505 -0.70385 0 -1.0176l2.9546 -5c0.1792 -0.303 0.5088 -0.4912 0.86085 -0.4912h4.0458v1H4.95425l-2.9541 5 1.3496 2.2842 -0.86135 0.5088Z" fill="#000000" stroke-width="0.5"></path>
+  <path id="_Transparent_Rectangle_" d="M0 0h16v16H0Z" fill="none" stroke-width="0.5"></path>
+</svg>

mcp_instana-0.3.0/mcpb/manifest.json

@@ -0,0 +1,83 @@
+{
+  "manifest_version": "0.2",
+  "name": "mcp-instana",
+  "display_name": "MCP Instana Server",
+  "version": "0.3.0",
+  "description": "MCP Instana Server for Observability",
+  "author": {
+    "name": "MCP Instana Team",
+    "email": "mcp-instana@ibm.com"
+  },
+  "homepage": "https://www.ibm.com/docs/en/instana-observability",
+  "support": "https://github.com/instana/mcp-instana/issues",
+  "icon": "assets/instana.svg",
+  "server": {
+    "type": "python",
+    "entry_point": "mcp-instana",
+    "mcp_config": {
+      "command": "python3",
+      "args": [
+        "-m",
+        "pipx",
+        "run",
+        "--spec",
+        "mcp-instana==${user_config.version}",
+        "mcp-instana",
+        "--transport",
+        "stdio"
+      ],
+      "env": {
+        "PYTHONPATH": "${__dirname}/lib",
+        "INSTANA_BASE_URL": "${user_config.instana_base_url}",
+        "INSTANA_API_TOKEN": "${user_config.instana_api_token}"
+      }
+    }
+  },
+  "user_config": {
+    "instana_base_url": {
+      "type": "string",
+      "title": "Instana Base URL",
+      "description": "Instana instance URL",
+      "default": "https://your-instana-url",
+      "required": true
+    },
+    "instana_api_token": {
+      "type": "string",
+      "title": "Instana API Token",
+      "description": "Your Instana API token",
+      "default": "",
+      "required": true,
+      "sensitive": true
+    },
+    "version": {
+      "type": "string",
+      "title": "Version",
+      "description": "Version of the mcp-instana package which is being installed.",
+      "default": "0.3.0",
+      "required": false
+    }
+  },
+  "keywords": [
+    "instana",
+    "obserability"
+  ],
+  "license": "Apache 2.0",
+  "privacy_policies": [
+    "https://github.com/instana/mcp-instana/blob/main/docs/PRIVACY.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/instana/mcp-instana"
+  },
+  "compatibility": {
+    "claude_desktop": ">=0.13.0",
+    "platforms": [
+      "darwin",
+      "win32",
+      "linux"
+    ],
+    "runtimes": {
+      "python": ">=3.10"
+    }
+  }
+}

{mcp_instana-0.2.1 → mcp_instana-0.3.0}/mcpb/pack.sh

@@ -1,8 +1,8 @@
 #!/bin/bash
 set -e
 
-# Read version from pyproject.toml
-VERSION=$(grep -E '^[[:space:]]*version[[:space:]]*=' pyproject.toml \
+# Read version from ../pyproject.toml
+VERSION=$(grep -E '^[[:space:]]*version[[:space:]]*=' ../pyproject.toml \
           | head -n1 \
           | sed -E 's/[[:space:]]*version[[:space:]]*=[[:space:]]*"([^"]+)".*/\1/')
 echo "Using version: $VERSION"
@@ -12,11 +12,12 @@ jq --arg ver "$VERSION" \
    '.version = $ver | .user_config.version.default = $ver' \
    manifest.json > manifest.tmp.json && mv manifest.tmp.json manifest.json
 
-# Python lib - install dependencies and pipx
-python -m pip install --target ./lib pipx click==8.1.8 packaging==24.2
+# Python lib
+python -m pip install -U pipx tomli --target ./lib
 
-# Install the package itself so pipx can find it
-python -m pip install --target ./lib .
+# Assets (logo, screenshots, etc)
+mkdir -p assets/
+cp ../docs/assets/* assets/
 
 # Pack
 npx -y @anthropic-ai/mcpb pack . mcp-instana.mcpb

{mcp_instana-0.2.1 → mcp_instana-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mcp-instana"
-version = "0.2.1"
+version = "0.3.0"
 description = "MCP server for Instana"
 authors = [
     {name = "Elina Priyadarshinee", email = "Elina.priyadarshinee1@ibm.com"},
@@ -22,18 +22,16 @@ license = {text = "Apache-2.0"}
 dependencies = [
     # Core MCP framework - imported in src/prompts/__init__.py and src/core/server.py
     "fastmcp==2.10.3",
-    
+    # MCP SDK for types and annotations
+    "mcp",
     # Instana API client - imported in src/event/events_tools.py
     "instana_client==1.0.0",
-    
     # HTTP client - imported in src/core/utils.py
     "requests==2.32.4",
-    
     # Environment loading - imported in src/core/server.py
     "python-dotenv==1.1.0",
-    
     # Data validation - imported in src/infrastructure/infrastructure_metrics.py
-    "pydantic==2.11.7",
+    "pydantic==2.11.7"
 ]
 
 # Development dependencies for testing, linting, and development

{mcp_instana-0.2.1 → mcp_instana-0.3.0}/src/application/application_alert_config.py

@@ -7,6 +7,11 @@ This module provides application alert configuration tools for Instana monitorin
 import logging
 from typing import Any, Dict, List, Optional, Union
 
+from mcp.types import ToolAnnotations
+
+from src.core.utils import BaseInstanaClient, register_as_tool, with_header_auth
+from src.prompts import mcp
+
 # Import the necessary classes from the SDK
 try:
     from instana_client.api.application_alert_configuration_api import (
@@ -18,8 +23,6 @@ except ImportError:
     logger.error("Failed to import application alert configuration API", exc_info=True)
     raise
 
-from src.core.utils import BaseInstanaClient, register_as_tool, with_header_auth
-
 # Configure logger for this module
 logger = logging.getLogger(__name__)
 
@@ -30,7 +33,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
         """Initialize the Application Alert MCP tools client."""
         super().__init__(read_token=read_token, base_url=base_url)
 
-    @register_as_tool
+    @register_as_tool(
+        title="Find Application Alert Config",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def find_application_alert_config(self,
                                             id: str,
@@ -78,7 +84,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             return {"error": f"Failed to get application alert config: {e!s}"}
 
 
-    @register_as_tool
+    @register_as_tool(
+        title="Find Application Alert Config Versions",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def find_application_alert_config_versions(self,
                                                      id: str,
@@ -126,7 +135,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in find_application_alert_config_versions: {e}", exc_info=True)
             return {"error": f"Failed to get application alert config versions: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Application Alert Configs",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def get_application_alert_configs(self,
                                             application_id: Optional[str] = None,
@@ -173,7 +185,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in get_application_alert_configs: {e}", exc_info=True)
             return {"error": f"Failed to get application alert configs: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Delete Application Alert Config",
+        annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=True)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def delete_application_alert_config(self,
                                               id: str,
@@ -214,7 +229,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in delete_application_alert_config: {e}", exc_info=True)
             return {"error": f"Failed to delete application alert config: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Enable Application Alert Config",
+        annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def enable_application_alert_config(self,
                                               id: str,
@@ -259,7 +277,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in enable_application_alert_config: {e}", exc_info=True)
             return {"error": f"Failed to enable application alert config: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Disable Application Alert Config",
+        annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def disable_application_alert_config(self,
                                                id: str,
@@ -304,7 +325,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in disable_application_alert_config: {e}", exc_info=True)
             return {"error": f"Failed to disable application alert config: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Restore Application Alert Config",
+        annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def restore_application_alert_config(self,
                                                id: str,
@@ -354,7 +378,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in restore_application_alert_config: {e}", exc_info=True)
             return {"error": f"Failed to restore application alert config: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Update Application Alert Config Baseline",
+        annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def update_application_alert_config_baseline(self,
                                                        id: str,
@@ -399,7 +426,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in update_application_alert_config_baseline: {e}", exc_info=True)
             return {"error": f"Failed to update application alert config baseline: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Create Application Alert Config",
+        annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def create_application_alert_config(self,
                                               payload: Union[Dict[str, Any], str],
@@ -521,7 +551,10 @@ class ApplicationAlertMCPTools(BaseInstanaClient):
             logger.error(f"Error in create_application_alert_config: {e}", exc_info=True)
             return {"error": f"Failed to create application alert config: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Update Application Alert Config",
+        annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAlertConfigurationApi)
     async def update_application_alert_config(self,
                                               id: str,

{mcp_instana-0.2.1/mcpb → mcp_instana-0.3.0}/src/application/application_analyze.py

@@ -7,6 +7,10 @@ This module provides application analyze tool functionality for Instana monitori
 import logging
 from typing import Any, Dict, List, Optional, Union
 
+from mcp.types import ToolAnnotations
+
+from src.prompts import mcp
+
 # Import the necessary classes from the SDK
 try:
     from instana_client.api.application_analyze_api import ApplicationAnalyzeApi
@@ -50,7 +54,10 @@ class ApplicationAnalyzeMCPTools(BaseInstanaClient):
             logger.error(f"Error initializing ApplicationAnalyzeApi: {e}", exc_info=True)
             raise
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Call Details",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAnalyzeApi)
     async def get_call_details(
         self,
@@ -97,7 +104,10 @@ class ApplicationAnalyzeMCPTools(BaseInstanaClient):
             logger.error(f"Error getting call details: {e}", exc_info=True)
             return {"error": f"Failed to get call details: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Trace Details",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAnalyzeApi)
     async def get_trace_details(
         self,
@@ -159,7 +169,10 @@ class ApplicationAnalyzeMCPTools(BaseInstanaClient):
             return {"error": f"Failed to get trace details: {e!s}"}
 
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get All Traces",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAnalyzeApi)
     async def get_all_traces(
         self,
@@ -287,7 +300,10 @@ class ApplicationAnalyzeMCPTools(BaseInstanaClient):
             logger.error(f"Error in get_traces: {e}")
             return {"error": f"Failed to get traces: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Grouped Trace Metrics",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAnalyzeApi)
     async def get_grouped_trace_metrics(
         self,
@@ -431,7 +447,10 @@ class ApplicationAnalyzeMCPTools(BaseInstanaClient):
             logger.error(f"Error in get_grouped_trace_metrics: {e}")
             return {"error": f"Failed to get grouped trace metrics: {e!s}"}
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Grouped Calls Metrics",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAnalyzeApi)
     async def get_grouped_calls_metrics(
         self,
@@ -585,7 +604,10 @@ class ApplicationAnalyzeMCPTools(BaseInstanaClient):
             return {"error": f"Failed to get grouped call: {e!s}"}
 
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Correlated Traces",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationAnalyzeApi)
     async def get_correlated_traces(
         self,

{mcp_instana-0.2.1 → mcp_instana-0.3.0}/src/application/application_catalog.py

@@ -11,11 +11,14 @@ import traceback
 from datetime import datetime, timedelta
 from typing import Any, Dict, Optional
 
+from mcp.types import ToolAnnotations
+
 from src.core.utils import (
     BaseInstanaClient,
     register_as_tool,
     with_header_auth,
 )
+from src.prompts import mcp
 
 try:
     from instana_client.api.application_catalog_api import (
@@ -38,7 +41,10 @@ class ApplicationCatalogMCPTools(BaseInstanaClient):
         """Initialize the Application Catalog MCP tools client."""
         super().__init__(read_token=read_token, base_url=base_url)
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Application Tag Catalog",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationCatalogApi)
     async def get_application_tag_catalog(self,
                                           use_case: Optional[str] = None,
@@ -106,7 +112,10 @@ class ApplicationCatalogMCPTools(BaseInstanaClient):
             return {"error": f"Failed to get application catalog: {e!s}"}
 
 
-    @register_as_tool
+    @register_as_tool(
+        title="Get Application Metric Catalog",
+        annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False)
+    )
     @with_header_auth(ApplicationCatalogApi)
     async def get_application_metric_catalog(self, ctx=None, api_client=None) -> Dict[str, Any]:
         """