gods-eye-view/docs/MCP_SETUP.md

MCP setup

Use God's Eye View from Claude and Codex: tools, links, and the live globe inside the conversation. Agents: follow these steps in order and check each one before going on.

1. Run the app

npm install
npm run build:panel   # the in-conversation globe; rerun after app changes
npm run dev           # http://localhost:5173, keep it running

The MCP server reads from this app. Check: curl -sI http://localhost:5173/panel/ answers 200.

2. Add the server to a client

The server is server/mcp/stdio.js in this checkout. Use absolute paths (clients do not load your shell profile), with each argument as its own entry.

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
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.

[mcp_servers.gods-eye-view]
command = "node"
args = ["/abs/path/gods-eye-view/server/mcp/stdio.js", "--api-base", "http://localhost:5173"]

{
  "mcpServers": {
    "gods-eye-view": {
      "command": "node",
      "args": ["/abs/path/gods-eye-view/server/mcp/stdio.js", "--api-base", "http://localhost:5173"]
    }
  }
}

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"].

3. Restart and try it

Fully quit the client (on Windows, from the tray icon) and reopen it, then start a new chat; clients keep the server they started with. Ask: "Show San Diego in God's Eye View with military flights on."

• Claude Desktop (a chat, not the Code tab), Codex and ChatGPT desktop show the live globe; the first load takes 10–20 seconds.
• Claude Code and the Codex CLI answer with data and a link.

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 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.
• Logs: the server writes each call, and why one failed, to stderr. Claude Desktop keeps it in its logs folder as mcp-server-gods-eye-view.log; in Codex, right-click the panel → DevTools for the panel's console.

See tools and the MCP server for what the tools do.