Skip to content

docs: add agentgateway MCP gateway integration guide - #197

Merged
majinghe merged 1 commit into
rustfs:mainfrom
majinghe:docs/agentgateway-mcp-integration
Nov 19, 2026
Merged

majinghe merged 1 commit into
rustfs:mainfrom
majinghe:docs/agentgateway-mcp-integration

Conversation

@majinghe

Copy link
Copy Markdown
Collaborator

Summary

New page developer/integration/ai/agentgateway.md in all five locales (en/zh/de/fr/ja): expose RustFS storage operations as remote MCP tools through agentgateway — configuration only, no RustFS code changes (verified end-to-end against agentgateway 1.7.0, the rustfs/mcp server, and RustFS 1.0.6).

The integration fills a real gap: the RustFS MCP server speaks stdio only (local subprocess), while agentgateway federates it as a stdio target and serves it as a remote MCP endpoint over Streamable HTTP with gateway-level authentication, rate limiting, and OpenTelemetry.

Contents:

  • MCP image build from the rustfs/mcp repository
  • agentgateway configuration with a stdio target (Docker launch, volume mount for the upload tool, AWS_ENDPOINT_URL via the Docker bridge gateway address)
  • Gateway startup and admin UI confirmation
  • Tool calls through the gateway with the MCP inspector: tools/list federates all six RustFS storage tools; create_bucket, upload_file, and get_object verified live
  • Round-trip verification: object created through the gateway confirmed via the S3 API and the console
  • Validation table and troubleshooting for every pitfall hit during testing: config passed as content (-c "$(cat config.yaml)"), Docker bridge endpoint addressing from the MCP container, upload_file path resolution inside the MCP server container, and the expected 406 on GET /mcp

Screenshots: agentgateway admin UI (1 configured MCP server, port 3000) and the RustFS console showing the gateway-uploaded object — Chinese UI for zh, English UI for other locales.

Cross-links to the new page added from the RustFS MCP server page (developer/mcp.md) in all five locales.

Validation

  • npm run docs:check: PASS (1000+ pages, locale tree parity, code-block parity, banned strings, image sizes)
  • npm run build: succeeds (4105 static files generated)
  • Live verification on a real deployment: MCP handshake, tool federation, bucket create, upload → S3 API confirm → read-back through the gateway, all passing

Verified end-to-end against agentgateway 1.7.0, the rustfs/mcp server,
and RustFS 1.0.6 (config-only integration, no code changes):

- agentgateway federates the RustFS MCP server as a stdio target and
  serves it as a remote MCP endpoint (Streamable HTTP) with gateway-level
  auth, rate limiting, and OpenTelemetry
- MCP image build from the rustfs/mcp repository
- Full tool federation verified: create_bucket, delete_bucket, get_object,
  list_buckets, list_objects, upload_file
- Round-trip verification: create bucket, upload through the gateway,
  confirm via S3 API, read back through the gateway
- Validation table and troubleshooting for pitfalls hit during testing:
  config passed as content (-c), Docker bridge endpoint addressing from
  the MCP container, upload path resolution inside the MCP server side,
  and the expected 406 on GET /mcp

Includes screenshots of the agentgateway admin UI and the RustFS console
showing gateway-uploaded objects (Chinese UI for zh, English for other
locales). Cross-links added from the RustFS MCP server page in all locales.
@majinghe
majinghe merged commit 885fdf0 into rustfs:main Nov 19, 2026
2 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant