Talk2Graph: mock viz MCP server + design notes

[silkspace]

Summary

• Mock viz MCP server that simulates the streamgl-viz MCP from PR graphistry/graphistry#3043, for testing Louie integration without a running Graphistry instance
• TALK2GRAPH_MCP_DESIGN.md with MCP design recommendations for the Graphistry team

Mock server

7 tools matching the Talk2Graph surface (list_sessions, get_session_info, set_encoding, reset_encoding, add_filter, reset_filters, get_data_sample) with two mock datasets:

• Cybersecurity: enterprise network traffic (Zeek conn.log, 1247 nodes, 3891 edges)
• Social media: Twitter #CyberSec influence graph (342 nodes, 1205 edges)

Run it:

# stdio
uv run python -m graphistry_mcp_server.mock_viz_server

# HTTP (for Louie)
uv run fastmcp run src/graphistry_mcp_server/mock_viz_server.py --transport streamable-http --port 3100

Design doc key points

• Louie needs zero code changes for V1 — existing MCP plugin handles everything
• V1: keep the 6 PR tools, add get_data_sample and animate flag on set_encoding
• V2 direction: create_collection tool with GFQL query + visual config
• MCP routing (PM2 workers) is Graphistry infra's problem, not Louie's
• Concrete next steps for Des, Manfred, and Jared

Test plan

• All 7 tools register correctly via FastMCP
• Tool calls return structurally correct responses
• Column validation rejects invalid attributes
• Encoding/filter state tracked across calls
• Integration test: register on local Louie, run full chat flow