Skip to content

AWS Labs Timestream for InfluxDB MCP Server

An AWS Labs Model Context Protocol (MCP) server for Timestream for InfluxDB. This server provides tools to interact with AWS Timestream for InfluxDB APIs, allowing you to create and manage database instances, clusters, parameter groups, and more. It also includes tools to interact with InfluxDB's write and query APIs.

Features

  • Create, update, list, describe, and delete Timestream for InfluxDB database instances
  • Create, update, list, describe, and delete Timestream for InfluxDB database clusters
  • Manage DB parameter groups
  • Tag management for Timestream for InfluxDB resources
  • Write and query data using InfluxDB's APIs

Pre-requisites

  1. Install uv from Astral or the GitHub README
  2. Install Python using uv python install 3.10
  3. Set up AWS credentials with access to AWS services
    • You need an AWS account with appropriate permissions
    • Configure AWS credentials with aws configure or environment variables
    • Consider starting with Read-only permission if you don't want the LLM to modify any resources

Installation

You can modify the settings of your MCP client to run your local server (e.g. for Amazon Q Developer CLI MCP, ~/.aws/amazonq/mcp.json)

{
  "mcpServers": {
    "awslabs.timestream-for-influxdb-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.timestream-for-influxdb-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "your-aws-profile",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Available Tools

The Timestream for InfluxDB MCP server provides the following tools:

AWS Timestream for InfluxDB Management

Database Cluster Management
  • CreateDbCluster: Create a new Timestream for InfluxDB database cluster
  • GetDbCluster: Retrieve information about a specific DB cluster
  • DeleteDbCluster: Delete a Timestream for InfluxDB database cluster
  • ListDbClusters: List all Timestream for InfluxDB database clusters
  • UpdateDbCluster: Update a Timestream for InfluxDB database cluster
  • ListDbClusters: List all Timestream for InfluxDB database clusters
  • ListDbInstancesForCluster: List DB instances belonging to a specific cluster
  • ListClustersByStatus: List DB clusters filtered by status
Database Instance Management
  • CreateDbInstance: Create a new Timestream for InfluxDB database instance
  • GetDbInstance: Retrieve information about a specific DB instance
  • DeleteDbInstance: Delete a Timestream for InfluxDB database instance
  • ListDbInstances: List all Timestream for InfluxDB database instances
  • UpdateDbInstance: Update a Timestream for InfluxDB database instance
  • ListDbInstancesByStatus: List DB instances filtered by status
Parameter Group Management
  • CreateDbParamGroup: Create a new DB parameter group
  • GetDbParameterGroup: Retrieve information about a specific DB parameter group
  • ListDbParamGroups: List all DB parameter groups
Tag Management
  • ListTagsForResource: List all tags on a Timestream for InfluxDB resource
  • TagResource: Add tags to a Timestream for InfluxDB resource
  • UntagResource: Remove tags from a Timestream for InfluxDB resource

InfluxDB Data Operations

Write API
  • InfluxDBWritePoints: Write data points to InfluxDB
  • InfluxDBWriteLP: Write data in Line Protocol format to InfluxDB
Query API
  • InfluxDBQuery: Query data from InfluxDB using Flux query language