agentgateway

Exposer les opérations de stockage RustFS comme outils MCP distants via la passerelle agentgateway.

agentgateway est un proxy IA-natif pour le trafic MCP, A2A et LLM. Sa passerelle MCP fédère les serveurs MCP et les expose sur le réseau avec authentification, politiques et observabilité OpenTelemetry. RustFS embarque son propre serveur MCP exposant les opérations de stockage comme outils, mais en stdio uniquement — utilisable comme sous-processus local, pas à distance. Ce guide connecte les deux : agentgateway lance le serveur MCP RustFS comme cible stdio et le sert comme point de terminaison MCP distant, afin que tout client MCP puisse opérer le stockage RustFS via la passerelle. Le workflow a été vérifié avec agentgateway 1.7.0, le serveur rustfs/mcp et RustFS 1.0.6.

Vous avez besoin de Docker sur l'hôte de la passerelle et d'un serveur RustFS joignable.

Architecture

La passerelle lance rustfs-mcp comme processus enfant et fait la translation entre son transport stdio et l'écoute MCP Streamable HTTP sur le port 3000. Les opérations de stockage passent par la passerelle — ses politiques, sa limitation de débit et sa télémétrie s'appliquent donc aussi aux appels d'outils de stockage objet.

Pourquoi une passerelle pour un serveur stdio

Un serveur MCP stdio n'est joignable que depuis la machine qui le lance. agentgateway ajoute le transport manquant — les clients distants se connectent en HTTP pendant que les identifiants S3 restent sur l'hôte de la passerelle.

Construire l'image du serveur MCP RustFS

Le serveur MCP vit dans son propre dépôt. Construisez l'image depuis les sources :

git clone https://github.com/rustfs/mcp.git rustfs-mcp
docker build -t rustfs/rustfs-mcp:latest rustfs-mcp

Le build produit une image qui exécute le serveur MCP en stdio et dialogue avec tout point de terminaison compatible S3 configuré via les variables d'environnement AWS_* standard.

Configurer agentgateway

Créez la configuration de la passerelle. La cible lance l'image MCP comme sous-processus ; le montage de volume expose un répertoire hôte pour l'outil de téléversement, et le point de terminaison pointe vers RustFS via l'adresse de passerelle du bridge Docker :

config.yaml
mcp:
  port: 3000
  targets:
  - name: rustfs
    stdio:
      cmd: docker
      args:
      - run
      - --rm
      - -i
      - -v
      - /data/agentgateway/demo:/demo
      - -e
      - AWS_ACCESS_KEY_ID=<your-access-key>
      - -e
      - AWS_SECRET_ACCESS_KEY=<your-secret-key>
      - -e
      - AWS_REGION=us-east-1
      - -e
      - AWS_ENDPOINT_URL=http://172.17.0.1:9000
      - rustfs/rustfs-mcp:latest

Adressage du point de terminaison depuis le conteneur MCP

Le serveur MCP tourne dans un conteneur — 127.0.0.1:9000 sur l'hôte RustFS ne lui est pas joignable. Utilisez l'adresse de passerelle du bridge Docker 172.17.0.1:9000 (ou un alias de réseau partagé). Si RustFS tourne lui-même dans Docker sur un réseau bridge personnalisé, Docker isole les bridges entre eux — rattachez les deux conteneurs au même réseau et utilisez le nom du conteneur.

Démarrez la passerelle avec le contenu de la configuration :

agentgateway -c "$(cat config.yaml)"

Le journal confirme les écouteurs : le bind MCP sur le port 3000, l'UI d'administration à http://localhost:15000/ui et un endpoint de statistiques sur 15020.

Page d'accueil de l'UI agentgateway montrant un serveur MCP configuré sur le port 3000

Appeler les outils RustFS via la passerelle

L'inspecteur MCP pilote la passerelle pour une vérification manuelle :

npx @modelcontextprotocol/inspector --cli http://localhost:3000/mcp --method tools/list
"tools": ["create_bucket", "delete_bucket", "get_object", "list_buckets", "list_objects", "upload_file"]

Créez un bucket et téléversez un fichier via la passerelle :

npx @modelcontextprotocol/inspector --cli http://localhost:3000/mcp \
  --method tools/call --tool-name create_bucket \
  --tool-arg bucket_name=agw-demo

npx @modelcontextprotocol/inspector --cli http://localhost:3000/mcp \
  --method tools/call --tool-name upload_file \
  --tool-arg local_file_path=/demo/hello.txt \
  --tool-arg bucket_name=agw-demo --tool-arg object_key=hello.txt
✅ **File uploaded successfully!**

Le chemin de téléversement est côté serveur MCP

upload_file lit local_file_path depuis le système de fichiers du processus exécutant le serveur MCP — donc depuis l'intérieur du conteneur. Le montage -v /data/agentgateway/demo:/demo de l'étape 2 expose un répertoire hôte en /demo dans le conteneur, ce qui permet à l'outil de lire le fichier.

Confirmer les objets dans RustFS

L'objet écrit via la passerelle atterrit dans le bucket comme toute écriture S3. Confirmez avec l'API S3, en remplaçant tous les paramètres fictifs :

aws s3api list-objects --bucket agw-demo \
  --endpoint-url http://localhost:9000
{
    "Contents": [
        {
            "Key": "hello.txt",
            "Size": 39,
            "StorageClass": "STANDARD"
        }
    ]
}

Relisez-le via la passerelle pour boucler la boucle :

npx @modelcontextprotocol/inspector --cli http://localhost:3000/mcp \
  --method tools/call --tool-name get_object \
  --tool-arg bucket_name=agw-demo --tool-arg object_key=hello.txt --tool-arg mode=read
Content: hello from rustfs-mcp via agentgateway

Console RustFS montrant l'objet hello.txt téléversé via agentgateway

Résultats de validation

VérificationRésultat attendu
Poignée de main MCP via la passerelleserverInfo.name rapporte rustfs-mcp-server avec le protocole 2025-03-26
tools/listLes six outils de stockage fédérés : create_bucket, delete_bucket, get_object, list_buckets, list_objects, upload_file
create_bucket via la passerelleLe bucket apparaît dans RustFS
upload_file via la passerelleL'objet atterrit dans le bucket ; visible dans la console et via l'API S3
get_object via la passerelleLe contenu correspond octet par octet au fichier téléversé
UI d'administration de la passerelleRapporte le serveur MCP configuré et le port

Dépannage

Error: invalid config: invalid type: string "config.yaml"

Le paramètre de configuration attend le contenu de la configuration, pas un chemin. Passez le contenu du fichier : agentgateway -c "$(cat config.yaml)".

Les outils MCP expirent ou signalent des erreurs de connexion

Le conteneur MCP ne peut pas joindre l'adresse RustFS. 127.0.0.1:9000 dans le conteneur désigne le conteneur lui-même — utilisez 172.17.0.1:9000 (passerelle du bridge Docker) ou un alias de réseau partagé, voir l'étape 2.

upload_file échoue avec un fichier local manquant

Le chemin est résolu dans le conteneur du serveur MCP. Montez le répertoire hôte dans le conteneur avec -v et référencez le chemin monté, voir l'étape 2.

GET /mcp renvoie 406 Not Acceptable

Attendu : le point de terminaison Streamable HTTP n'accepte que des requêtes POST avec les en-têtes Accept: application/json, text/event-stream — utilisez un client MCP comme l'inspecteur plutôt qu'un navigateur.

Prochaines étapes

Sur cette page