Repository navigation
docs: add agentgateway MCP gateway integration guide - #197
Merged
Merged
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
New page
developer/integration/ai/agentgateway.mdin 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:
rustfs/mcprepositoryAWS_ENDPOINT_URLvia the Docker bridge gateway address)tools/listfederates all six RustFS storage tools;create_bucket,upload_file, andget_objectverified live-c "$(cat config.yaml)"), Docker bridge endpoint addressing from the MCP container,upload_filepath resolution inside the MCP server container, and the expected 406 onGET /mcpScreenshots: 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)