Skip to content

WIP: Local MCP Server Config#180

Merged
bpstewar merged 2 commits into
mainfrom
local-mcp
Mar 27, 2026
Merged

WIP: Local MCP Server Config#180
bpstewar merged 2 commits into
mainfrom
local-mcp

Conversation

@Gabe-Levin
Copy link
Copy Markdown
Collaborator

@Gabe-Levin Gabe-Levin commented Mar 27, 2026

Add Space2Stats MCP Server

What I changed

  • Added a new space2stats_mcp/ package — an MCP (Model Context Protocol) server that exposes the Space2Stats API as tools for AI assistants (Claude Desktop, Claude Code, Cursor, VS Code Copilot, etc.)
  • 11 tools covering data discovery (list_fields, list_topics), admin boundary fetching (fetch_admin_boundaries), and spatial queries (get_summary, get_aggregate, get_timeseries) plus hex-level variants
  • STAC catalog integration to enrich results with field descriptions, topics, and source metadata
  • .mcp.json at the repo root for automatic server configuration in supported IDEs
  • README with installation, configuration for 5+ MCP clients, and testing instructions

How to test it

  1. Install the package: pip install -e space2stats_mcp/
  2. Start the server: space2stats-mcp (should start without errors, waiting for JSON-RPC input — Ctrl+C to stop)
  3. Verify tools work:
    • list_fields → returns 106 fields
    • fetch_admin_boundaries with {"iso3": "AND", "adm": "ADM0"} → returns GeoJSON
    • get_aggregate with a small AOI → returns aggregated statistics
  4. Or test in Claude Code: open the repo, confirm the MCP connects, and ask "What population fields are available in Space2Stats?"

@Gabe-Levin Gabe-Levin temporarily deployed to Space2Stats API Dev March 27, 2026 13:04 — with GitHub Actions Inactive
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Mar 27, 2026

PR Deployment Details:
🚀 PR deployed to https://r5kh8bh6m4.execute-api.us-east-1.amazonaws.com/

@bpstewar bpstewar self-requested a review March 27, 2026 16:32
@bpstewar bpstewar merged commit b66e034 into main Mar 27, 2026
6 checks passed
@bpstewar bpstewar had a problem deploying to Space2Stats API Dev March 27, 2026 16:33 — with GitHub Actions Failure
@bpstewar bpstewar temporarily deployed to Space2Stats API Dev March 27, 2026 16:36 — with GitHub Actions Inactive
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants