From b7b606b5b71da64226a56223e8bba3c0dd608166 Mon Sep 17 00:00:00 2001 From: Huanyi Xie <74809554+xiehuanyi@users.noreply.github.com> Date: Mon, 5 Oct 2026 12:43:58 +0300 Subject: [PATCH 1/2] docs(mcp): use the default app port in client setup --- docs/MCP_SETUP.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/MCP_SETUP.md b/docs/MCP_SETUP.md index ec11d923b..735504cec 100644 --- a/docs/MCP_SETUP.md +++ b/docs/MCP_SETUP.md @@ -9,7 +9,7 @@ one before going on. ```sh npm install npm run build:panel # the in-conversation globe; rerun after app changes -npm run dev # http://localhost:5173, keep it running +npm run dev # http://localhost:4173, keep it running ``` The MCP server reads from this app. @@ -21,15 +21,15 @@ The server is `server/mcp/stdio.js` in this checkout. Use absolute paths | Client | How | | --- | --- | -| Claude Code | `claude mcp add gods-eye-view -- node /abs/path/gods-eye-view/server/mcp/stdio.js --api-base http://localhost:5173` | -| Codex CLI | `codex mcp add gods-eye-view -- node /abs/path/gods-eye-view/server/mcp/stdio.js --api-base http://localhost:5173` | +| Claude Code | `claude mcp add gods-eye-view -- node /abs/path/gods-eye-view/server/mcp/stdio.js --api-base http://localhost:4173` | +| Codex CLI | `codex mcp add gods-eye-view -- node /abs/path/gods-eye-view/server/mcp/stdio.js --api-base http://localhost:4173` | | Codex and ChatGPT desktop | Same `~/.codex/config.toml` as the CLI (block below), or Settings → MCP servers → Add server (STDIO). | | Claude Desktop | Settings → Developer → Edit Config, then add the JSON below. | ```toml [mcp_servers.gods-eye-view] command = "node" -args = ["/abs/path/gods-eye-view/server/mcp/stdio.js", "--api-base", "http://localhost:5173"] +args = ["/abs/path/gods-eye-view/server/mcp/stdio.js", "--api-base", "http://localhost:4173"] ``` ```json @@ -37,7 +37,7 @@ args = ["/abs/path/gods-eye-view/server/mcp/stdio.js", "--api-base", "http://loc "mcpServers": { "gods-eye-view": { "command": "node", - "args": ["/abs/path/gods-eye-view/server/mcp/stdio.js", "--api-base", "http://localhost:5173"] + "args": ["/abs/path/gods-eye-view/server/mcp/stdio.js", "--api-base", "http://localhost:4173"] } } } @@ -45,7 +45,7 @@ args = ["/abs/path/gods-eye-view/server/mcp/stdio.js", "--api-base", "http://loc **Windows with the checkout in WSL:** use `"command": "wsl.exe"` and put `"-e"` and the absolute Linux path to `node` first in `args`, for example -`["-e", "/home/you/.local/share/mise/installs/node/24/bin/node", "/home/you/gods-eye-view/server/mcp/stdio.js", "--api-base", "http://localhost:5173"]`. +`["-e", "/home/you/.local/share/mise/installs/node/24/bin/node", "/home/you/gods-eye-view/server/mcp/stdio.js", "--api-base", "http://localhost:4173"]`. ## 3. Restart and try it @@ -60,7 +60,7 @@ Diego in God's Eye View with military flights on."* ## Troubleshooting - **The server does not appear:** run the command from step 2 in a terminal; - it should print `God's Eye View MCP server reading http://localhost:5173` + it should print `God's Eye View MCP server reading http://localhost:4173` and wait. A path or `args` mistake fails here. - **The panel says it could not load:** `npm run build:panel` was not run, or the dev server is down. From 2d3d99864b022c6a5f14909acd615ea06a1372c1 Mon Sep 17 00:00:00 2001 From: Sameh Khamis Date: Wed, 7 Oct 2026 14:37:10 -0700 Subject: [PATCH 2/2] docs: credit both contributors for MCP port correction Credit the equivalent contribution in PR #959 alongside PR #934, while preserving the original PR author's commits. Co-authored-by: shirunjies8-png --- CHANGELOG.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2eb1bf8b9..51cbda5e3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,9 @@ # Changelog +- MCP setup examples use the app's default port, `4173`. Thanks to + [Huanyi Xie](https://github.com/xiehuanyi) (#934) and + [shirunjies8-png](https://github.com/shirunjies8-png) (#959) for the same fix. + - Voice revisits numbered analyst records through current layer snapshots and preserves resolved pin coordinates. Requested analyst lists and rankings can speak returned items alongside the exact count and coverage caveats. Failed