Rocky Geo Mcp

创建者

racccoinorg2 months ago

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

概览内容工具评论

概览

rockygeo-mcp

Install

npm install
npm run build

Configure

Variable	Default	Notes
`RAPIDAPI_KEY`	(required)	Sent as `x-rapidapi-key`. Override with `--api-key <k>`.
`ROCKYGEO_BASE_URL`	`https://rocky-geo.p.rapidapi.com/v1`	Point at a self-hosted RockyGeo if you have one.
`ROCKYGEO_RAPIDAPI_HOST`	parsed from base URL	Sent as `x-rapidapi-host` for `*.rapidapi.com` hosts.

MCP client setup

Add to your client config (Claude Code ~/.claude.json, Claude Desktop claude_desktop_config.json, etc.):

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

Tools

lookup_ip — { ip: string } → geolocation for one IP. Private/reserved IPs return { found: false }.
lookup_ips_batch — { ips: string[] } (1–100) → { results: { [ip]: ... } }.
health_check — {} → { status, dataVersion, lastSyncAt, uptime }.

Smoke test with the inspector

RAPIDAPI_KEY=<key> npx @modelcontextprotocol/inspector node dist/index.js

Then in the inspector UI: list tools, run lookup_ip with { "ip": "8.8.8.8" }.

Integration tests

End-to-end tests in tests/integration.test.js spawn the built server as a child process and exercise every tool over the real MCP stdio transport, hitting the live RockyGeo API.

npm test

If RAPIDAPI_KEY is not in the environment, the runner prompts for it (input is hidden). The runner also auto-builds dist/ if it is missing.

Note: tests hit the real upstream API, so they consume RapidAPI quota and may be rate-limited on the Free plan (1 RPS).

License

MIT.

服务器配置

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

Playwright McpPlaywright MCP server

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code

CursorThe AI Code Editor

RedisA Model Context Protocol server that provides access to Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.

WindsurfThe new purpose-built IDE to harness magic

ChatWiseThe second fastest AI chatbot™

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.

Howtocook Mcp基于Anduin2017 / HowToCook （程序员在家做饭指南）的mcp server，帮你推荐菜谱、规划膳食，解决“今天吃什么“的世纪难题； Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"

Jina AI MCP ToolsA Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.