refactor: load MCP guide from external file

.gitignore

@@ -4,7 +4,8 @@ __pycache__/
 *.egg-info/
 
 # Internal documents
-/docs/
+/docs/internal/
+/docs/tasks/
 
 # Common files
 *.log

app.py

@@ -5,6 +5,7 @@ import sys
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), "src"))
 
 import logging
+from pathlib import Path
 
 import gradio as gr
 import spaces
@@ -23,6 +24,10 @@ logger = logging.getLogger(__name__)
 
 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. Click 'Start New Game' to begin._"
 
@@ -294,58 +299,7 @@ _{personality_desc}_"""
 
         # MCP Server Tab
         with gr.TabItem("MCP Server"):
-            gr.Markdown(
-                """
-## MCP Server Guide
-
-This application functions as an **MCP (Model Context Protocol) Server**.
-External LLMs can connect to this server and use game management tools.
-
-### Connection URL
-
-```
-https://<space-name>.hf.space/gradio_api/mcp/
-```
-
-For local development:
-```
-http://localhost:7860/gradio_api/mcp/
-```
-
-### How to Connect
-
-#### Claude Desktop / Cursor / VS Code
-
-Add the following to your MCP settings configuration:
-
-```json
-{
-  "mcpServers": {
-    "unpredictable-lord": {
-      "url": "https://<space-name>.hf.space/gradio_api/mcp/"
-    }
-  }
-}
-```
-
-### Available Tools
-
-| Tool | Description |
-|------|-------------|
-| `init_game` | Initialize a new game session. Returns a session_id and available advice options. |
-| `get_game_state` | Get the current game state for a session. |
-| `list_available_advice` | Get all available advice options for execute_turn. |
-| `execute_turn` | Execute a turn with the given advice. Returns whether advice was adopted and results. |
-
-### Usage Flow
-
-1. Call `init_game(personality)` to start a new game session
-2. User gives free-form advice to the Lord AI
-3. Lord AI interprets advice and calls `execute_turn(session_id, advice)`
-4. Lord AI explains the result to the user (adopted/rejected, action taken, effects)
-5. Repeat from step 2 until game over
-"""
-            )
+            gr.Markdown(MCP_GUIDE_CONTENT)
 
             gr.Markdown("### Test: Initialize Game")
             with gr.Row():

docs/mcp_guide.md

@@ -0,0 +1,49 @@
+# MCP Server Guide
+
+This application functions as an **MCP (Model Context Protocol) Server**.
+External LLMs can connect to this server and use game management tools.
+
+## Connection URL
+
+```
+https://<space-name>.hf.space/gradio_api/mcp/
+```
+
+For local development:
+
+```
+http://localhost:7860/gradio_api/mcp/
+```
+
+## How to Connect
+
+### Claude Desktop / Cursor / VS Code
+
+Add the following to your MCP settings configuration:
+
+```json
+{
+  "mcpServers": {
+    "unpredictable-lord": {
+      "url": "https://<space-name>.hf.space/gradio_api/mcp/"
+    }
+  }
+}
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `init_game` | Initialize a new game session. Returns a session_id and available advice options. |
+| `get_game_state` | Get the current game state for a session. |
+| `list_available_advice` | Get all available advice options for execute_turn. |
+| `execute_turn` | Execute a turn with the given advice. Returns whether advice was adopted and results. |
+
+## Usage Flow
+
+1. Call `init_game(personality)` to start a new game session
+2. User gives free-form advice to the Lord AI
+3. Lord AI interprets advice and calls `execute_turn(session_id, advice)`
+4. Lord AI explains the result to the user (adopted/rejected, action taken, effects)
+5. Repeat from step 2 until game over