doct: add tool_prefix to MCP Guide

app.py

@@ -23,7 +23,7 @@ from unpredictable_lord.mcp_server.mcp_server import (
     list_available_advice,
 )
 from unpredictable_lord.settings import ENABLE_GRADIO_DEPRECATION_WARNING, LOGGING_LEVEL
-from unpredictable_lord.utils import get_tool_prefix
+from unpredictable_lord.utils import get_tool_prefix, update_guide_with_tool_prefix
 
 # Configure logging level from environment variable
 log_level = getattr(logging, LOGGING_LEVEL, logging.INFO)
@@ -41,10 +41,6 @@ logger = logging.getLogger(__name__)
 logger.info(f"Gradio version: {gr.__version__}")
 logger.info(f"ZeroGPU: {spaces.config.Config.zero_gpu}")
 
-# Load MCP guide from external file
-MCP_GUIDE_PATH = Path(__file__).parent / "docs" / "mcp_guide.md"
-MCP_GUIDE_CONTENT = MCP_GUIDE_PATH.read_text(encoding="utf-8")
-
 # Constants
 NO_GAME_MESSAGE = """_No active game._
 
@@ -53,6 +49,10 @@ NO_GAME_MESSAGE = """_No active game._
 2. Click "⚔️ Start New Game"
 """
 
+# Load MCP guide from external file
+MCP_GUIDE_PATH = Path(__file__).parent / "docs" / "mcp_guide.md"
+MCP_GUIDE_TEMPLATE = MCP_GUIDE_PATH.read_text(encoding="utf-8")
+
 # MCP tool prefix for HF Spaces
 tool_prefix = get_tool_prefix()
 logger.info(f"Using tool prefix: '{tool_prefix}'")
@@ -388,7 +388,7 @@ _{personality_desc}_"""
 
         # MCP Server Tab
         with gr.TabItem("MCP Server", id="mcp_server"):
-            gr.Markdown(MCP_GUIDE_CONTENT)
+            gr.Markdown(update_guide_with_tool_prefix(tool_prefix, MCP_GUIDE_TEMPLATE))
 
             gr.Markdown("### Test: Initialize Game")
             with gr.Row():

src/unpredictable_lord/utils.py

@@ -16,3 +16,17 @@ def get_tool_prefix() -> str:
         prefix = prefix.replace("-", "_")
         return prefix
     return ""
+
+
+def update_guide_with_tool_prefix(prefix: str, mcp_guide: str) -> str:
+    """Apply tool prefix to MCP guide content."""
+    for tool_name in [
+        "init_game",
+        "get_game_state",
+        "list_available_advice",
+        "execute_turn",
+    ]:
+        # Replace tool names in backticks and in function calls
+        mcp_guide = mcp_guide.replace(f"`{tool_name}`", f"`{prefix}{tool_name}`")
+        mcp_guide = mcp_guide.replace(f"`{tool_name}(", f"`{prefix}{tool_name}(")
+    return mcp_guide