From 4e31eea55fba7926b467f9345101669dec3dcf0e Mon Sep 17 00:00:00 2001
From: yxkong <5ycode@sina.com>
Date: Thu, 24 Apr 2025 09:20:26 +0800
Subject: [PATCH] Fix/mcp doc (#7239)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

### What problem does this PR solve?

This PR fixes an issue with the MCP server configuration in RAGFlow's
Docker deployment where:
1. Incorrect parameter naming (`--mcp--host-api-key` with double
hyphens) caused server startup failures
2. Port binding conflicts occurred due to unexposed MCP ports in Docker
3. Inconsistent host addressing between `0.0.0.0` and `127.0.0.1` led to
connectivity issues

The changes ensure proper MCP server initialization and reliable
inter-service communication.

### Type of change

- [x] Bug Fix (non-breaking change which fixes an issue)
- [ ] New Feature (non-breaking change which adds functionality)
- [ ] Documentation Update
- [ ] Refactoring
- [ ] Performance Improvement
- [ ] Other (please describe):

### Key Changes

1. **Parameter Correction**:
   - Fixed `--mcp--host-api-key` → `--mcp-host-api-key`
---
 docker/docker-compose.yml | 2 +-
 docs/develop/mcp.md       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docker/docker-compose.yml b/docker/docker-compose.yml
index b1962cce9..b9e41df39 100644
--- a/docker/docker-compose.yml
+++ b/docker/docker-compose.yml
@@ -16,7 +16,7 @@ services:
     #   - --mcp-base-url=http://127.0.0.1:9380
     #   - --mcp-script-path=/ragflow/mcp/server/server.py
     #   - --mcp-mode=self-host
-    #   - --mcp--host-api-key="ragflow-xxxxxxx"
+    #   - --mcp-host-api-key="ragflow-xxxxxxx"
     container_name: ragflow-server
     ports:
       - ${SVR_HTTP_PORT}:9380
diff --git a/docs/develop/mcp.md b/docs/develop/mcp.md
index 239e8813b..e13ac15fc 100644
--- a/docs/develop/mcp.md
+++ b/docs/develop/mcp.md
@@ -81,7 +81,7 @@ services:
       - --mcp-base-url=http://127.0.0.1:9380
       - --mcp-script-path=/ragflow/mcp/server/server.py
       - --mcp-mode=self-host # `self-host` or `host`
-      - --mcp--host-api-key="ragflow-xxxxxxx" # only need to privide when mode is `self-host`
+      - --mcp-host-api-key="ragflow-xxxxxxx" # only need to privide when mode is `self-host`
 ```
 
 Then launch it normally `docker compose -f docker-compose.yml`.