Skip to content

v0.6.0 — starmapper-mcp: Claude Code / MCP integration

Choose a tag to compare

View all tags
@FlorianBruniaux FlorianBruniaux released this 09 Jun 07:12
v0.6.0
411f58e

Claude Code / MCP Integration

starmapper-mcp is a standalone npm package that wraps StarMapper's API as an MCP (Model Context Protocol) server. Claude Code users can query any indexed repo's audience data from the terminal, trigger re-indexation, and get audience breakdowns directly in their AI conversations.

{ "mcpServers": { "starmapper": { "command": "npx", "args": ["starmapper-mcp"] } } }

Nine tools

  • get_repo_stats: total stars, geocoded count, top countries, top cities, organic score summary
  • get_organic_score: signal breakdown with weights, active signals, reasons, and 85.7% corpus accuracy label
  • get_velocity: per-country star velocity (last 30 days vs prior 60-day window) with rising / new / stable / declining labels
  • get_influential_stargazers: stargazers above a follower threshold (default 500, max 1,000,000), sorted by influence, capped at 50 results
  • index_repo: drives the full chunk loop from the MCP client, geocodes all stargazers, and saves the result to StarMapper's shared cache
  • health_check: pings the StarMapper API and returns status and latency
  • get_cache_status: returns cache metadata for a repo (scanned date, mapped count, total) without transferring the full stargazer blob
  • get_trending: returns the current trending repos from StarMapper's trending feed
  • list_repos: lists all repos indexed on StarMapper, ordered by last scan date

New API routes

  • GET /api/mcp/organic-score/[owner]/[repo]: full organic score signal breakdown. Recomputes signals live. Public. Cache-Control: public, s-maxage=300, stale-while-revalidate=600.
  • GET /api/mcp/influential/[owner]/[repo]?minFollowers=N: influential stargazers above a follower threshold (0 to 1,000,000, default 500). Public, no auth gate. Hard-capped at 50 results.

Set STARMAPPER_BASE_URL to point at a self-hosted instance.

Assets 2
Loading