English Français العربية

io.github.CloudCorpRecords/streetmap-port

السجل الرسمي أخرى

Geocode, reverse geocode and find nearby places with the public OpenStreetMap APIs.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @reneturcios/streetmap-port
Claude Code 
claude mcp add streetmap-port -- npx -y @reneturcios/streetmap-port@0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "streetmap-port": {
            "command": "npx",
            "args": [
                "-y",
                "@reneturcios/streetmap-port@0.1.0",
                "mcp"
            ]
        }
    }
}
OCI package ghcr.io/cloudcorprecords/streetmap-port:0.1.0
Claude Code 
claude mcp add streetmap-port -- docker run -i --rm ghcr.io/cloudcorprecords/streetmap-port:0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "streetmap-port": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/cloudcorprecords/streetmap-port:0.1.0",
                "mcp"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. streetmap-port
  2. Install
  3. CLI
  4. MCP tools
  5. Docker
  6. Development

streetmap-port

OpenStreetMap geography as a CLI and a stdio MCP server in one bin: geocode a name to coordinates, reverse geocode coordinates to an address, search places, look up an OSM object by type and id, find places of a category near a point, and compute great-circle distances locally.

Geocoding, reverse geocoding and lookup use the public Nominatim API (with the descriptive User-Agent its usage policy requires); nearby search uses the public Overpass API. All requests go through an injectable fetch function, coordinates are validated before any request is built, and API error payloads are surfaced as errors — never replaced with invented places. distance_between is a pure local haversine computation and makes no API call.

Install

npx -y @reneturcios/streetmap-port mcp

CLI

streetmap-port mcp
streetmap-port geocode <query...>
streetmap-port reverse <lat> <lon>
streetmap-port search <query...>
streetmap-port nearby <lat> <lon> [category] [radius-m]
streetmap-port distance <lat1> <lon1> <lat2> <lon2>
streetmap-port --version

Exit codes: 0 success, 1 API/validation error, 2 usage error.

MCP tools

ToolPurpose
geocode_addressGeocode a free-form address or place name to coordinates via the OSM Nominatim API
reverse_geocodeReverse geocode coordinates to the nearest address via the OSM Nominatim API
search_placesSearch for places by name via the OSM Nominatim API
find_nearbyFind places of a category near coordinates via the OSM Overpass API
get_place_detailsGet details of one OSM object (node, way or relation) via the Nominatim lookup API
distance_betweenCompute the great-circle distance in kilometres between two coordinate pairs (local, no API call)

MCP client config:

{
  "mcpServers": {
    "streetmap-port": {
      "command": "npx",
      "args": ["-y", "@reneturcios/streetmap-port", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/streetmap-port          # MCP server
docker run --rm ghcr.io/cloudcorprecords/streetmap-port --version

Development

npm install
npm run build
npm test

Data © OpenStreetMap contributors (ODbL). MIT license for the code.

الأسئلة الشائعة

ما هو io.github.CloudCorpRecords/streetmap-port؟

Geocode, reverse geocode and find nearby places with the public OpenStreetMap APIs.

كيف أثبّت io.github.CloudCorpRecords/streetmap-port؟

يعمل على جهازك. في Claude Code: claude mcp add streetmap-port -- npx -y @reneturcios/streetmap-port@0.1.0 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.CloudCorpRecords/streetmap-port إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.CloudCorpRecords/streetmap-port مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.CloudCorpRecords/streetmap-port؟

ينشره CloudCorpRecords. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.