Release v1.3.0 by jstirnaman · Pull Request #30 · influxdata/influxdb3_mcp_server

jstirnaman · 2026-03-24T22:00:44Z

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

Add e2e test suite with MCP protocol compliance tests #29 — E2E test suite, CLAUDE.md, Claude Code skills (merged)
fix: add data.message check to query error handler, add error-path tests #31 — fix: add data.message check to query error handler, add error-path tests (merged)
fix(query): surface plain-text error responses from InfluxDB Core #24 — fix(query): surface plain-text error responses from InfluxDB Core
Bump axios from 1.12.2 to 1.13.5 #20 — Bump axios from 1.12.2 to 1.13.5
Bump js-yaml from 4.1.0 to 4.1.1 #10 — Bump js-yaml from 4.1.0 to 4.1.1
Bump flatted from 3.3.3 to 3.4.2 #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

Bumps [js-yaml](https://github.com/nodeca/js-yaml) from 4.1.0 to 4.1.1. - [Changelog](https://github.com/nodeca/js-yaml/blob/master/CHANGELOG.md) - [Commits](nodeca/js-yaml@4.1.0...4.1.1) --- updated-dependencies: - dependency-name: js-yaml dependency-version: 4.1.1 dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com>

Bumps [axios](https://github.com/axios/axios) from 1.12.2 to 1.13.5. - [Release notes](https://github.com/axios/axios/releases) - [Changelog](https://github.com/axios/axios/blob/v1.x/CHANGELOG.md) - [Commits](axios/axios@v1.12.2...v1.13.5) --- updated-dependencies: - dependency-name: axios dependency-version: 1.13.5 dependency-type: direct:production ... Signed-off-by: dependabot[bot] <support@github.com>

InfluxDB v3 Core returns query errors as plain strings in the response body rather than JSON objects with an `error` field. The error handler was only checking `response.data.error`, so plain-text errors fell through to the generic `statusText`, producing unhelpful "Internal Server Error" messages. Add a fallback to extract the message when `response.data` is a string.

Bumps [flatted](https://github.com/WebReflection/flatted) from 3.3.3 to 3.4.2. - [Commits](WebReflection/flatted@v3.3.3...v3.4.2) --- updated-dependencies: - dependency-name: flatted dependency-version: 3.4.2 dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com>

…d-3.4.2 Bump flatted from 3.3.3 to 3.4.2

# Conflicts: # package-lock.json # package.json

…1.13.5 Bump axios from 1.12.2 to 1.13.5

…l-4.1.1 Bump js-yaml from 4.1.0 to 4.1.1

Bumps all deps to latest within existing ^ranges: - @typescript-eslint/eslint-plugin 8.35→8.57.2 - @typescript-eslint/parser 8.35→8.57.2 - @eslint/js 9.29→9.39.4, eslint 9.29→9.39.4 - @types/node 24.0→24.12.0 - @influxdata/influxdb3-client 1.1→1.4.0 - prettier 3.5→3.8.1, typescript 5.8→5.9.3 - dotenv 16.5→16.6.1, zod 3.25.67→3.25.76 - js-yaml 4.1.0→4.1.1 (transitive via eslint) Major version bumps (eslint 10, typescript 6, zod 4, dotenv 17, influxdb3-client 2) deferred to a future PR.

Apply the same string fallback from PR #24 (query.service.ts) to database-management, cloud-token-management, and serverless-schema-management services. InfluxDB Core returns errors as plain strings in all HTTP responses, not just queries.

Gated on influxdata org + main branch only. Uses a GitHub environment (cloud-serverless) with scoped secrets for the API token and region URL. Reuses the existing integration.test.ts — no new test file needed. Also adds workflow_dispatch trigger for manual re-runs. Requires setup: create cloud-serverless environment in repo settings with INFLUXDB_CLOUD_URL and INFLUXDB_CLOUD_TOKEN secrets, and a read-only mcp-ci-tests bucket in the Cloud Serverless org.

fix(query): surface plain-text error responses from InfluxDB Core

handleQueryError in query.service.ts checked data.error but not data.message. Cloud Serverless returns {"code":"...","message":"..."}, so the specific error detail was lost to the generic statusText fallback. Add data.message to the extraction chain, matching the pattern already used in database-management, cloud-token-management, and serverless-schema-management services. Add unit tests with recorded error fixtures from live Core and Cloud Serverless instances covering: - Core JSON errors (404, 400) via data.error - Core plain-text errors (500) via string fallback - Serverless SDK HttpError via error.message - Serverless {code,message} JSON via data.message (the fixed path) - Integration error tests for live Core (gated)

Bumps [flatted](https://github.com/WebReflection/flatted) from 3.3.3 to 3.4.2. - [Commits](WebReflection/flatted@v3.3.3...v3.4.2) --- updated-dependencies: - dependency-name: flatted dependency-version: 3.4.2 dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com>

…d-3.4.2 Bump flatted from 3.3.3 to 3.4.2

- Swap data.error/data.message order in handleQueryError to match the other 3 services (data.message first, consistent extraction) - Replace ?? "" fallbacks with conditional env var passing in both integration test files, so BASE_ENV defaults are preserved when env vars are unset

fix: add data.message check to query error handler, add error-path tests

Add Archestra MCP Trust Score badge to README

Resolve conflicts in package.json and package-lock.json: - Keep PR's exact-pinning strategy (no caret ranges) - Adopt axios 1.15.2 from main (newer than PR's 1.13.6) - Regenerate package-lock.json — 0 vulnerabilities

jstirnaman · 2026-05-18T16:06:02Z

Conflict resolution + release prep

Merged origin/main (28 commits, mostly dependabot bumps) into release/v1.3.0.

Conflicts resolved

package.json: kept PR's exact-pinning strategy (no caret ranges), adopted axios@1.15.2 from main (newer than PR's 1.13.6). Other deps already newer in PR.
package-lock.json: regenerated from resolved package.json.

Verification

Check	Result
`npm install`	clean, 0 vulnerabilities
`npm run build`	passes
`npm test` (protocol + unit)	17 passed, 5 skipped
`npm run lint`	passes
Version consistency (package.json / config.ts / CHANGELOG.md)	all `1.3.0`

Also updated

CHANGELOG release date → 2026-05-18 (today) to reflect the actual ship day.

PR is now MERGEABLE. Ready for final review and merge.

- [P1] Add publishConfig.access=public so the scoped @influxdata/* package publishes publicly on first npm publish. - [P2] Skip cloud-serverless integration job for forked PRs — fork runs cannot access environment secrets and would otherwise fail on empty credentials.

jstirnaman · 2026-05-18T16:22:43Z

Review findings addressed

Severity	Finding	Resolution
P1	Scoped package missing public publish config	Added `"publishConfig": { "access": "public" }` to `package.json`. First `npm publish` will now publish publicly without needing `--access public`.
P2	Cloud-serverless job runs on forked PRs without secrets	Tightened `if:` to also require `github.event.pull_request.head.repo.full_name == github.repository` (or `push`). Fork PRs no longer trigger the job.

Tests still green (17 passed, 5 skipped without live cloud creds).

Commit: 8ea77c0

Matvey-Kuk and others added 14 commits August 15, 2025 21:46

Add MCP Catalog Trust Score badge

e79a029

Merge pull request #26 from influxdata/dependabot/npm_and_yarn/flatte…

60ec99d

…d-3.4.2 Bump flatted from 3.3.3 to 3.4.2

Merge remote-tracking branch 'origin/release/v1.3.0' into fix/axios-bump

590e32b

# Conflicts: # package-lock.json # package.json

Merge pull request #20 from influxdata/dependabot/npm_and_yarn/axios-…

6530900

…1.13.5 Bump axios from 1.12.2 to 1.13.5

Merge pull request #10 from influxdata/dependabot/npm_and_yarn/js-yam…

aaf9579

…l-4.1.1 Bump js-yaml from 4.1.0 to 4.1.1

Merge pull request #24 from EthanKang1/main

112dbc2

fix(query): surface plain-text error responses from InfluxDB Core

Allow Cloud Serverless CI on PRs, gate with environment approval

2ea54fa

jstirnaman temporarily deployed to cloud-serverless March 24, 2026 22:29 — with GitHub Actions Inactive

jstirnaman and others added 3 commits March 24, 2026 20:34

Merge pull request #34 from influxdata/dependabot/npm_and_yarn/flatte…

1b8350a

…d-3.4.2 Bump flatted from 3.3.3 to 3.4.2

jstirnaman temporarily deployed to cloud-serverless March 26, 2026 15:09 — with GitHub Actions Inactive

jstirnaman added 2 commits March 26, 2026 10:38

Merge pull request #31 from influxdata/fix/query-error-message-gap

eac85d7

fix: add data.message check to query error handler, add error-path tests

jstirnaman temporarily deployed to cloud-serverless March 26, 2026 15:39 — with GitHub Actions Inactive

Merge pull request #5 from Matvey-Kuk/add-mcp-badge

08a43f2

Add Archestra MCP Trust Score badge to README

jstirnaman temporarily deployed to cloud-serverless March 26, 2026 15:50 — with GitHub Actions Inactive

jstirnaman changed the title ~~fix: surface plain-text error responses, add Cloud Serverless CI~~ Release v1.3.0 Mar 26, 2026

Update CHANGELOG.md for v1.3.0 release

1d9d93d

jstirnaman temporarily deployed to cloud-serverless March 26, 2026 15:53 — with GitHub Actions Inactive

Add CI status badge to README, comment out unit/lint badges for future

81a349d

jstirnaman temporarily deployed to cloud-serverless March 26, 2026 15:58 — with GitHub Actions Inactive

Pin all dependency versions to exact (no caret ranges)

76b1eed

jstirnaman temporarily deployed to cloud-serverless March 26, 2026 17:48 — with GitHub Actions Inactive

Rename npm package to @influxdata/influxdb3-mcp-server

4fbacc2

jstirnaman temporarily deployed to cloud-serverless March 26, 2026 18:03 — with GitHub Actions Inactive

Add package rename and dependency pinning to CHANGELOG

52a1e59

jstirnaman temporarily deployed to cloud-serverless March 26, 2026 18:09 — with GitHub Actions Inactive

jstirnaman added 2 commits May 18, 2026 11:03

Merge origin/main into release/v1.3.0

0dfb3e7

Resolve conflicts in package.json and package-lock.json: - Keep PR's exact-pinning strategy (no caret ranges) - Adopt axios 1.15.2 from main (newer than PR's 1.13.6) - Regenerate package-lock.json — 0 vulnerabilities

chore: update CHANGELOG release date to ship day

da51675

jstirnaman temporarily deployed to cloud-serverless May 18, 2026 16:05 — with GitHub Actions Inactive

docs: call out influxdb3-client bump in CHANGELOG

20554cb

jstirnaman temporarily deployed to cloud-serverless May 18, 2026 16:15 — with GitHub Actions Inactive

jstirnaman temporarily deployed to cloud-serverless May 18, 2026 16:22 — with GitHub Actions Inactive

docs: note publishConfig in CHANGELOG

3cad1b4

jstirnaman temporarily deployed to cloud-serverless May 18, 2026 16:31 — with GitHub Actions Inactive

jstirnaman merged commit bd0097d into main May 18, 2026
4 checks passed

jstirnaman deleted the release/v1.3.0 branch May 18, 2026 16:39

Navigation Menu

Uh oh!

Release v1.3.0 - #30

Release v1.3.0#30
jstirnaman merged 30 commits into
mainfrom
release/v1.3.0

jstirnaman commented Mar 24, 2026 •

edited

Loading

Uh oh!

jstirnaman commented May 18, 2026

Uh oh!

jstirnaman commented May 18, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

jstirnaman commented Mar 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Release v1.3.0

Added

Fixed

Changed

Verified against live instances

PRs included

Uh oh!

jstirnaman commented May 18, 2026

Conflict resolution + release prep

Conflicts resolved

Verification

Also updated

Uh oh!

jstirnaman commented May 18, 2026

Review findings addressed

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

jstirnaman commented Mar 24, 2026 •

edited

Loading