Merge pull request #30 from influxdata/release/v1.3.0

## Release v1.3.0

This is the first official release under the @influxdata scope and contains breaking changes, including the package name change to `@influxdata/influxdb3-mcp-server`. However, the MCP tools, resources, and prompts are unchanged.

### Added

- **E2E test suite**: Protocol compliance tests (vitest) — 10 tests verifying server startup, MCP handshake, tool/resource/prompt registration, and error handling. No InfluxDB required.
- **Integration tests**: Live InfluxDB tests for `health_check`, `list_databases`, and `execute_query`, gated behind `INFLUX_TEST_ENABLED`
- **Error-path unit tests**: 7 tests with recorded error fixtures from live Core and Cloud Serverless covering JSON, plain-text, and `{code, message}` error formats
- **CI workflow**: GitHub Actions with protocol tests on every PR, integration tests against Core via Docker, and Cloud Serverless tests via GitHub environment secrets
- **Docker test infrastructure**: `docker-compose.test.yml` for local Core testing with preconfigured admin token
- **Version consistency CI check**: Fails if `package.json`, `config.ts`, and `CHANGELOG.md` versions disagree
- **CLAUDE.md**: Architecture overview and codebase conventions for Claude Code
- **Claude Code skills**: Build/run workflow for Core/Enterprise and testing workflow

### Fixed

- Server-level error catch now sets `isError: true`, consistent with handler-level error responses
- Plain-text error responses from InfluxDB Core (HTTP 500) surfaced in all 4 services
- Query error handler now checks `data.message` for Cloud Serverless `{code, message}` JSON errors
- Query error handler extraction order aligned with other services (`data.message` before `data.error`)

### Changed

- npm package renamed from `influxdb-mcp-server` to `@influxdata/influxdb3-mcp-server`
- Minimum Node.js version raised to v20.11 (Node 18 is EOL)
- `@modelcontextprotocol/sdk` updated from `^1.12.1` to `1.27.1`
- All dependencies updated and pinned to exact versions (no caret ranges)
- Version aligned to 1.3.0 across `package.json`, `config.ts`, and `CHANGELOG.md`

## Verified against live instances

| Target | Tests | Result |
|---|---|---|
| Protocol (no InfluxDB) | 10 protocol + 7 error-path unit | All pass |
| InfluxDB 3 Core (Docker) | 3 happy-path + 2 error-path | All pass |
| InfluxDB Cloud Serverless | 3 happy-path | All pass |

## PRs included

- #29 — E2E test suite, CLAUDE.md, Claude Code skills (merged)
- #31 — fix: add data.message check to query error handler, add error-path tests (merged)
- #24 — fix(query): surface plain-text error responses from InfluxDB Core
- #20 — Bump axios from 1.12.2 to 1.13.5
- #10 — Bump js-yaml from 4.1.0 to 4.1.1
- #26 — Bump flatted from 3.3.3 to 3.4.2
- Dependency updates within semver ranges, then pinned to exact versions
- Version alignment to 1.3.0
- npm package rename to `@influxdata/influxdb3-mcp-server`
- CI workflow with version check, Core integration, and Cloud Serverless integration

Author: jstirnaman

.claude/skills/build-run-core-enterprise/references/mcp-client-configs.md

@@ -36,7 +36,7 @@ to npm first:
   "mcpServers": {
     "influxdb": {
       "command": "npx",
-      "args": ["-y", "influxdb-mcp-server"],
+      "args": ["-y", "@influxdata/influxdb3-mcp-server"],
       "env": {
         "INFLUX_DB_INSTANCE_URL": "http://localhost:8181/",
         "INFLUX_DB_TOKEN": "<YOUR_TOKEN>",

.github/workflows/ci.yml

@@ -5,6 +5,7 @@ on:
     branches: [main]
   pull_request:
     branches: [main]
+  workflow_dispatch:
 
 jobs:
   check-versions:
@@ -101,7 +102,38 @@ jobs:
         if: always()
         run: docker stop influxdb3-core && docker rm influxdb3-core
 
+  test-integration-cloud-serverless:
+    name: Integration tests (InfluxDB Cloud Serverless)
+    runs-on: ubuntu-latest
+    # Skip on forked PRs — environment secrets (INFLUXDB_CLOUD_URL/TOKEN) are
+    # not exposed to fork runs, which would fail on empty credentials.
+    if: |
+      github.repository_owner == 'influxdata' &&
+      (github.event_name == 'push' ||
+       github.event.pull_request.head.repo.full_name == github.repository)
+    environment: cloud-serverless
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f  # v6.3.0
+        with:
+          node-version: "22"
+          cache: "npm"
+
+      - run: npm ci
+      - run: npm run build
+
+      - name: Integration tests
+        run: npm run test:integration
+        env:
+          INFLUX_TEST_ENABLED: "true"
+          INFLUX_DB_INSTANCE_URL: ${{ secrets.INFLUXDB_CLOUD_URL }}
+          INFLUX_DB_TOKEN: ${{ secrets.INFLUXDB_CLOUD_TOKEN }}
+          INFLUX_DB_PRODUCT_TYPE: "cloud-serverless"
+
   # Future: test-integration-enterprise
   # Requires Enterprise Docker image and license key.
   # Gate with: if: github.repository_owner == 'influxdata'
-  # Pass license via: secrets.INFLUXDB_ENTERPRISE_LICENSE
+  # Environment: enterprise (with INFLUXDB_ENTERPRISE_LICENSE secret)

CHANGELOG.md

@@ -5,25 +5,35 @@ All notable changes to the official InfluxDB MCP Server will be documented in th
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.3.0] - 2026-03-24
+## [1.3.0] - 2026-05-18
 
 ### Added
 
 - **E2E test suite**: Protocol compliance tests (vitest) that verify server startup, MCP handshake, tool/resource/prompt registration, and error handling — no InfluxDB required
 - **Integration tests**: Live InfluxDB tests for `health_check`, `list_databases`, and `execute_query`, gated behind `INFLUX_TEST_ENABLED`
-- **CI workflow**: GitHub Actions with protocol tests on every PR and integration tests against InfluxDB 3 Core via Docker
+- **Error-path unit tests**: Tests with recorded error fixtures from live Core and Cloud Serverless instances covering JSON, plain-text, and `{code, message}` error formats
+- **CI workflow**: GitHub Actions with protocol tests on every PR, integration tests against InfluxDB 3 Core via Docker, and Cloud Serverless integration tests via GitHub environment secrets
 - **Docker test infrastructure**: `docker-compose.test.yml` for local Core testing with preconfigured admin token
+- **Version consistency CI check**: Verifies `package.json`, `config.ts`, and `CHANGELOG.md` versions match on every PR
 - **CLAUDE.md**: Architecture overview and codebase conventions for Claude Code
 - **Claude Code skills**: Build/run workflow for Core/Enterprise and testing workflow
 
 ### Fixed
 
 - Server-level error catch now sets `isError: true`, consistent with handler-level error responses
+- Plain-text error responses from InfluxDB Core (HTTP 500) are now surfaced in all 4 services instead of falling through to generic "Internal Server Error"
+- Query error handler now checks `data.message` for Cloud Serverless `{code, message}` JSON error format, matching the other 3 services
 
 ### Changed
 
 - Minimum Node.js version raised to v20.11 (Node 18 is EOL; vitest 4.x and `import.meta.dirname` require v20.11+)
-- `@modelcontextprotocol/sdk` updated from `^1.12.1` to `^1.27.1`
+- `@modelcontextprotocol/sdk` updated from `^1.12.1` to `1.27.1`
+- `@influxdata/influxdb3-client` updated from `^1.1.0` to `1.4.0`
+- All dependencies updated to latest within semver ranges
+- Version aligned across `package.json`, `config.ts`, and `CHANGELOG.md` (previously divergent)
+- npm package renamed from `influxdb-mcp-server` to `@influxdata/influxdb3-mcp-server`
+- Scoped package configured for public publish (`publishConfig.access: "public"`)
+- All dependencies pinned to exact versions (no caret ranges)
 
 ## [1.2.0] - 2025-11-05
 

README.md

@@ -1,5 +1,10 @@
 # InfluxDB MCP Server
 
+[![CI](https://github.com/influxdata/influxdb3_mcp_server/actions/workflows/ci.yml/badge.svg)](https://github.com/influxdata/influxdb3_mcp_server/actions/workflows/ci.yml)
+<!-- [![Unit Tests](https://github.com/influxdata/influxdb3_mcp_server/actions/workflows/unit.yml/badge.svg)](https://github.com/influxdata/influxdb3_mcp_server/actions/workflows/unit.yml) -->
+<!-- [![Lint](https://github.com/influxdata/influxdb3_mcp_server/actions/workflows/lint.yml/badge.svg)](https://github.com/influxdata/influxdb3_mcp_server/actions/workflows/lint.yml) -->
+[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/influxdata/influxdb3_mcp_server)](https://archestra.ai/mcp-catalog/influxdata__influxdb3_mcp_server)
+
 Model Context Protocol (MCP) server for InfluxDB 3 integration. Provides tools, resources, and prompts for interacting with InfluxDB v3 (Core/Enterprise/Cloud Dedicated/Clustered/Cloud Serverless) via MCP clients.
 
 ---
@@ -200,7 +205,7 @@ See corresponding `env.<instancetype>.example` for examples and detailed info.
      "mcpServers": {
        "influxdb": {
          "command": "npx",
-         "args": ["-y", "@modelcontextprotocol/server-influxdb"],
+         "args": ["-y", "@influxdata/influxdb3-mcp-server"],
          "env": {
            "INFLUX_DB_INSTANCE_URL": "http://localhost:8181/",
            "INFLUX_DB_TOKEN": "<YOUR_INFLUXDB_TOKEN>",

example-npx.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "influxdb": {
       "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-influxdb"],
+      "args": ["-y", "@influxdata/influxdb3-mcp-server"],
       "env": {
         "INFLUX_DB_INSTANCE_URL": "http://localhost:8086/",
         "INFLUX_DB_TOKEN": "<YOUR_INFLUXDB_OPERATOR_TOKEN>",