/** The local MCP server: Core's tools over services backed by a running app. */ import { randomBytes } from 'node:crypto'; import { readFileSync } from 'node:fs'; import { composeCatalog, coreTools, catalogForSurface, } from '../../src/tools/index.js'; import { createGlobePanelResource, panelRuntime, } from '../../src/tools/panel.js'; import { createMcpServer } from '../../src/tools/mcp/index.js'; import { DEFAULT_API_BASE, createLocalToolServices } from './services.js'; const INSTRUCTIONS = "Tools answer questions from God's Eye View's live public data. Location " + 'tools take an area: a place name, a bbox, or lat/lon with radius_km. ' + 'Results are capped; check truncated and total before concluding there is nothing more. ' + "Answers that can be shown in God's Eye View include data.view; to show one, call " + 'show_in_gods_eye_view with that view, adding layers, style, a camera or marks as ' + "needed. It shows live God's Eye View where the client displays apps and " + 'returns a link everywhere.'; /** Construct the local MCP server for Core's tools. */ export function createLocalMcpServer({ apiBase = DEFAULT_API_BASE, fetchImpl, panelKey = randomBytes(32).toString('base64url'), } = {}) { const { version } = JSON.parse( readFileSync(new URL('../../package.json', import.meta.url), 'utf8'), ); // Unless given one, each server makes a new key for its panel. The panel's // page carries it and panel_request requires it; any client may read the // page, so it keeps the tool from clients that only list it, and is not // access control. The stdio entry passes the install's shared key // (panelKey.js), so separate processes of one client agree. return createMcpServer({ catalog: catalogForSurface( composeCatalog({ tools: coreTools, services: createLocalToolServices({ apiBase, fetchImpl, panelKey }), }), 'mcp', ), name: 'gods-eye-view', version, instructions: INSTRUCTIONS, resources: [createGlobePanelResource({ runtime: panelRuntime, panelKey })], }); }