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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.prometheus-mcp-server
-Version: 0.1.1
+Version: 0.2.1
 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/
@@ -47,6 +47,8 @@ This MCP server is designed to be fully compatible with Amazon Q developer CLI,
 
 ## Installation
 
+[![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)
+
 ### Prerequisites
 
 - Python 3.10 or higher
@@ -69,23 +71,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 +116,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 +163,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.1.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.1.dist-info/METADATA,sha256=OX9MRYv46osZ4nS6-C0lknASjH5BujuzYDHzeY-qEtg,6640
+awslabs_prometheus_mcp_server-0.2.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+awslabs_prometheus_mcp_server-0.2.1.dist-info/entry_points.txt,sha256=vOT5qHrh2r_C0eht0Iu42IOBCeWaBlZ6bud_-0jbuFg,92
+awslabs_prometheus_mcp_server-0.2.1.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
+awslabs_prometheus_mcp_server-0.2.1.dist-info/licenses/NOTICE,sha256=4WcOZNSeVgbIVslS5AjRYmqYyv5S3xHylu2kSEXgXeQ,30
+awslabs_prometheus_mcp_server-0.2.1.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,,