awslabs.prometheus-mcp-server 0.1.1__py3-none-any.whl → 0.2.2__py3-none-any.whl

{awslabs_prometheus_mcp_server-0.1.1.dist-info → awslabs_prometheus_mcp_server-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.prometheus-mcp-server
-Version: 0.1.1
+Version: 0.2.2
 Summary: MCP server for interacting with AWS Managed Prometheus
 Project-URL: homepage, https://awslabs.github.io/mcp/
 Project-URL: docs, https://awslabs.github.io/mcp/servers/prometheus-mcp-server/
@@ -24,7 +24,7 @@ Requires-Python: >=3.10
 Requires-Dist: boto3>=1.38.7
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: loguru>=0.7.0
-Requires-Dist: mcp[cli]>=1.7.0
+Requires-Dist: mcp[cli]>=1.11.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: requests>=2.32.3
@@ -47,6 +47,10 @@ This MCP server is designed to be fully compatible with Amazon Q developer CLI,
 
 ## Installation
 
+| Cursor | VS Code |
+|:------:|:-------:|
+| [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.prometheus-mcp-server&config=eyJjb21tYW5kIjoidXZ4IGF3c2xhYnMucHJvbWV0aGV1cy1tY3Atc2VydmVyQGxhdGVzdCAtLXVybCBodHRwczovL2Fwcy13b3Jrc3BhY2VzLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tL3dvcmtzcGFjZXMvd3MtPFdvcmtzcGFjZSBJRD4gLS1yZWdpb24gPFlvdXIgQVdTIFJlZ2lvbj4gLS1wcm9maWxlIDxZb3VyIENMSSBQcm9maWxlIFtkZWZhdWx0XSBpZiBubyBwcm9maWxlIGlzIHVzZWQ%2BIiwiZW52Ijp7IkZBU1RNQ1BfTE9HX0xFVkVMIjoiREVCVUciLCJBV1NfUFJPRklMRSI6IjxZb3VyIENMSSBQcm9maWxlIFtkZWZhdWx0XSBpZiBubyBwcm9maWxlIGlzIHVzZWQ%2BIn19) | [![Install on VS Code](https://img.shields.io/badge/Install_on-VS_Code-FF9900?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Prometheus%20MCP%20Server&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.prometheus-mcp-server%40latest%22%2C%22--url%22%2C%22https%3A%2F%2Faps-workspaces.us-east-1.amazonaws.com%2Fworkspaces%2Fws-%3CWorkspace%20ID%3E%22%2C%22--region%22%2C%22%3CYour%20AWS%20Region%3E%22%2C%22--profile%22%2C%22%3CYour%20CLI%20Profile%20%5Bdefault%5D%20if%20no%20profile%20is%20used%3E%22%5D%2C%22env%22%3A%7B%22FASTMCP_LOG_LEVEL%22%3A%22DEBUG%22%2C%22AWS_PROFILE%22%3A%22%3CYour%20CLI%20Profile%20%5Bdefault%5D%20if%20no%20profile%20is%20used%3E%22%7D%7D) |
+
 ### Prerequisites
 
 - Python 3.10 or higher
@@ -69,23 +73,41 @@ mkdir -p ~/.aws/amazonq/
 ```
 
 2. Add the following to `~/.aws/amazonq/mcp.json`:
+
+### Basic Configuration
+```json
+{
+  "mcpServers": {
+    "prometheus": {
+      "command": "uvx",
+      "args": [
+        "awslabs.prometheus-mcp-server@latest"
+      ],
+      "env": {
+        "FASTMCP_LOG_LEVEL": "DEBUG"
+      }
+    }
+  }
+}
+```
+
+### Configuration with Optional Arguments
 ```json
 {
   "mcpServers": {
-    "awslabs.prometheus-mcp-server": {
+    "prometheus": {
       "command": "uvx",
       "args": [
         "awslabs.prometheus-mcp-server@latest",
         "--url",
-        "https://aps-workspaces.us-east-1.amazonaws.com/workspaces/ws-<Workspace ID>",
+        "https://aps-workspaces.<AWS Region>.amazonaws.com/workspaces/ws-<Workspace ID>",
         "--region",
         "<Your AWS Region>",
         "--profile",
-        "<Your CLI Profile [default] if no profile is used>"
+        "<Your CLI Profile>"
       ],
       "env": {
-        "FASTMCP_LOG_LEVEL": "DEBUG",
-        "AWS_PROFILE": "<Your CLI Profile [default] if no profile is used>"
+        "FASTMCP_LOG_LEVEL": "DEBUG"
       }
     }
   }
@@ -96,30 +118,46 @@ mkdir -p ~/.aws/amazonq/
 
 ## Available Tools
 
-1. **execute_query**
+1. **GetAvailableWorkspaces**
+   - List all available Prometheus workspaces in the specified region
+   - Parameters: region (optional)
+   - Returns: List of workspaces with IDs, aliases, and status
+
+2. **ExecuteQuery**
    - Execute instant PromQL queries against Prometheus
-   - Parameters: query (required), time (optional)
+   - Parameters: workspace_id (required), query (required), time (optional), region (optional)
 
-2. **execute_range_query**
+3. **ExecuteRangeQuery**
    - Execute PromQL queries over a time range
-   - Parameters: query, start time, end time, step interval
+   - Parameters: workspace_id (required), query, start time, end time, step interval, region (optional)
 
-3. **list_metrics**
+4. **ListMetrics**
    - Retrieve all available metric names from Prometheus
+   - Parameters: workspace_id (required), region (optional)
    - Returns: Sorted list of metric names
 
-4. **get_server_info**
+5. **GetServerInfo**
    - Retrieve server configuration details
+   - Parameters: workspace_id (required), region (optional)
    - Returns: URL, region, profile, and service information
 
 ## Example Queries
 
 ```python
+# Get available workspaces
+workspaces = await get_available_workspaces()
+for ws in workspaces['workspaces']:
+    print(f"ID: {ws['workspace_id']}, Alias: {ws['alias']}, Status: {ws['status']}")
+
 # Execute an instant query
-result = await execute_query("up")
+result = await execute_query(
+    workspace_id="ws-12345678-abcd-1234-efgh-123456789012",
+    query="up"
+)
 
 # Execute a range query
 data = await execute_range_query(
+    workspace_id="ws-12345678-abcd-1234-efgh-123456789012",
     query="rate(node_cpu_seconds_total[5m])",
     start="2023-01-01T00:00:00Z",
     end="2023-01-01T01:00:00Z",
@@ -127,10 +165,14 @@ data = await execute_range_query(
 )
 
 # List available metrics
-metrics = await list_metrics()
+metrics = await list_metrics(
+    workspace_id="ws-12345678-abcd-1234-efgh-123456789012"
+)
 
 # Get server information
-info = await get_server_info()
+info = await get_server_info(
+    workspace_id="ws-12345678-abcd-1234-efgh-123456789012"
+)
 ```
 
 ## Troubleshooting

awslabs_prometheus_mcp_server-0.2.2.dist-info/RECORD

@@ -0,0 +1,11 @@
+awslabs/__init__.py,sha256=O4wlFva3THWmjfaXfJAwi29mxJSKIhM0jcebVfd3S5U,615
+awslabs/prometheus_mcp_server/__init__.py,sha256=5IA_Tu-_9Y_SEzlcDrt9JQhlDIOXR86l3Z45K5YgNuo,676
+awslabs/prometheus_mcp_server/consts.py,sha256=ZkZsypCBRvVuT17llXmD9GFqtC5Qi-6wrEBQuaIsq9M,1875
+awslabs/prometheus_mcp_server/models.py,sha256=dfF9iUUtvmNiVWdKR-2RhkBIWqnBf33u_wM-6BWiPss,1837
+awslabs/prometheus_mcp_server/server.py,sha256=-Gp0iWkCdGuf59W6qNXA5LKX4tsX24vE_XLmWS6GqEw,42086
+awslabs_prometheus_mcp_server-0.2.2.dist-info/METADATA,sha256=t1NhQH_iw595vIi3saBKh6BqmZbJujJnph76x55hdSQ,7438
+awslabs_prometheus_mcp_server-0.2.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+awslabs_prometheus_mcp_server-0.2.2.dist-info/entry_points.txt,sha256=vOT5qHrh2r_C0eht0Iu42IOBCeWaBlZ6bud_-0jbuFg,92
+awslabs_prometheus_mcp_server-0.2.2.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
+awslabs_prometheus_mcp_server-0.2.2.dist-info/licenses/NOTICE,sha256=4WcOZNSeVgbIVslS5AjRYmqYyv5S3xHylu2kSEXgXeQ,30
+awslabs_prometheus_mcp_server-0.2.2.dist-info/RECORD,,

awslabs_prometheus_mcp_server-0.1.1.dist-info/RECORD

@@ -1,11 +0,0 @@
-awslabs/__init__.py,sha256=O4wlFva3THWmjfaXfJAwi29mxJSKIhM0jcebVfd3S5U,615
-awslabs/prometheus_mcp_server/__init__.py,sha256=s1zDdDhGr3NBV69b-JNnE1zkUYfOQSCTZaEU7zIA1wU,676
-awslabs/prometheus_mcp_server/consts.py,sha256=ZkZsypCBRvVuT17llXmD9GFqtC5Qi-6wrEBQuaIsq9M,1875
-awslabs/prometheus_mcp_server/models.py,sha256=yU7Ta7Ei0DItUJY4t3QDFwSNk8xkBQ-Hwynej_IC080,4231
-awslabs/prometheus_mcp_server/server.py,sha256=ev74dNSwsTGRnidrqRPW5sWd2giyy5W1heRxLq9WrcE,23294
-awslabs_prometheus_mcp_server-0.1.1.dist-info/METADATA,sha256=U45KUHnYFUbpBuOmkIri-6h_Hbg0ji55ISxITt1dYiw,5038
-awslabs_prometheus_mcp_server-0.1.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-awslabs_prometheus_mcp_server-0.1.1.dist-info/entry_points.txt,sha256=vOT5qHrh2r_C0eht0Iu42IOBCeWaBlZ6bud_-0jbuFg,92
-awslabs_prometheus_mcp_server-0.1.1.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
-awslabs_prometheus_mcp_server-0.1.1.dist-info/licenses/NOTICE,sha256=4WcOZNSeVgbIVslS5AjRYmqYyv5S3xHylu2kSEXgXeQ,30
-awslabs_prometheus_mcp_server-0.1.1.dist-info/RECORD,,