Rocky Geo MCP Server

@racccoinorg

代码仓库

基本信息

分类

开发工具

传输方式

stdio

作者

racccoinorg

提交者

Ruslan

关于 Rocky Geo MCP Server

MCP (Model Context Protocol) server that wraps the RockyGeo IP geolocation API hosted on RapidAPI. Lets MCP-compatible clients (Claude Desktop, Claude Code, etc.) perform IPv4/IPv6 geolocation lookups via tool calls

#ip #geo #api #mcp#rapidapi

Rocky Geo MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "rockygeo": {
      "command": "node",
      "args": [
        "/Users/cyborg97/rockygeomcp/dist/index.js"
      ],
      "env": {
        "RAPIDAPI_KEY": "<your-key>"
      }
    }
  }
}

Rocky Geo MCP Server 工具

`{ ip: string }` → geolocation for one IP. Private/reserved IPs return `{ found: false }`.

`{ ips: string[] }` (1–100) → `{ results: { [ip]: ... } }`.

`{}` → `{ status, dataVersion, lastSyncAt, uptime }`.

概览

What is Rocky Geo Mcp?

A Model Context Protocol (MCP) server that wraps the RockyGeo IP geolocation API on RapidAPI. It lets MCP-compatible clients like Claude Desktop or Claude Code perform IPv4/IPv6 geolocation lookups via tool calls.

How to use Rocky Geo Mcp?

Install with npm install && npm run build, then configure the RAPIDAPI_KEY environment variable (or pass via --api-key). Add the server to your MCP client config (e.g., claude_desktop_config.json) using the node command pointing at the built dist/index.js file.

Key features of Rocky Geo Mcp

Single‑IP geolocation via lookup_ip tool
Batch geolocation (1–100 IPs) via lookup_ips_batch
Health check endpoint (health_check) returning status and data version
Supports both IPv4 and IPv6 addresses
Configurable base URL for self‑hosted RockyGeo instances
Private/reserved IPs return { found: false }

Use cases of Rocky Geo Mcp

Look up the geographical location of an IP address for security analysis
Enrich log data by batch‑geolocating multiple IPs at once
Verify connectivity and data freshness of the geolocation service

常见问题

How do I handle private or reserved IP addresses?

The server returns `{ found: false }` for private or reserved IPs, indicating no geolocation data is available.

What is the batch size limit for IP lookups?

The `lookup_ips_batch` tool accepts between 1 and 100 IP addresses per call.

Is an API key required?

Yes, a RapidAPI key (`RAPIDAPI_KEY`) is required and must be set either as an environment variable or passed with `--api-key`. The free RapidAPI plan allows 1 request per second.

Can I use a self‑hosted RockyGeo backend?

Yes, set the `ROCKYGEO_BASE_URL` environment variable to point at your own instance. The default is `https://rocky-geo.p.rapidapi.com/v1`.

How are tests run?

End‑to‑end integration tests are in `tests/integration.test.js` and can be run with `npm test`. They hit the live RockyGeo API, so they consume RapidAPI quota and may be rate‑limited on the free plan.

开发工具分类下的更多 MCP 服务器

Meticulous

Foremerge

naw103

Catch intent conflicts before code conflicts. The open-source coordination protocol for coding agents, built above Git.

Official Porkbun MCP Server

Porkbun LLC

Official Porkbun MCP server, maintained by Porkbun. Check domain availability and pricing, register, renew and transfer domains, and manage DNS records, nameservers, URL forwarding, glue records, DNSSEC and domain contac

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

CodeSentinel

icohangar-ops

Codebase health as MCP tools: dead code, circular dependencies, coupling, architectural drift.