Mapport

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Nov 1, 2026

Geocoding, places, directions, distance, and elevation through Google Maps.

已驗證STDIO僅桌面位置與生活開發者工具

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理透過 Google Maps Platform 進行地理編碼、地點搜尋與詳情、路線、距離與海拔查詢。

可以做什麼
  • 將地址轉換為座標，也把座標反查為地址
  • 依文字查詢搜尋地點（可限定中心點與半徑），並取得聯絡資訊、評分、營業時間等詳情
  • 取得含分段指引、距離與時間的路線，並計算多組起點與終點之間的距離與時間矩陣
  • 查詢一個或多個座標的海拔高度
適用情境
適合助理需要在使用者本機取得真實的地點、地址、路線或地形資料時使用，例如規劃行程、解析地址或比較通行時間。
執行需求
透過 npx 或 Docker 映像以 stdio 在本機執行；需要 Google Maps Platform API 金鑰，放在 GOOGLE_MAPS_API_KEY 環境變數中，並需要連線至 Google 的網路。僅支援桌面端。
安裝前請注意
API 金鑰會以查詢參數隨每次請求傳送給 Google，屬於可能計費的 Google Maps Platform 憑證，應妥善限制與保護；呼叫會消耗 Google 配額並可能產生費用。此伺服器只讀取地圖資料，不會修改任何內容。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mapport，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

mapport

mapport turns plain questions about places into answers from the Google Maps Platform: an address becomes coordinates, coordinates become an address, a text query becomes a list of places, and any two points become a distance, a duration, or a step-by-step route. It also reports how high a point sits above sea level. One binary serves both a command-line interface for scripts and a stdio MCP server for agents, and both faces share the same request logic.

A Google Maps Platform API key is required. Put it in the GOOGLE_MAPS_API_KEY environment variable; it is sent to Google as the key query parameter on every request and never appears in output. When the variable is missing, every call fails with an error that names it, before any request is made.

Install

bash
npx @reneturcios/mapport geocode "1600 Amphitheatre Parkway"

Or run the container image:

bash
docker run -i -e GOOGLE_MAPS_API_KEY ghcr.io/cloudcorprecords/mapport

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

bash
export GOOGLE_MAPS_API_KEY="your API key"
mapport geocode "1600 Amphitheatre Parkway, Mountain View"mapport reverse 37.422 -122.084mapport search "coffee near the ferry building" --lat 37.7955 --lng -122.3937 --radius 1500mapport details ChIJ2eUgeAK6j4ARbn5u_wAGqWAmapport distance "San Francisco" "Oakland" --to "Berkeley" --mode drivingmapport elevation 37.422,-122.084 40.0,-70.0mapport directions "San Francisco" "San Jose" --mode transit
mapport --version

Each command prints the upstream JSON payload. Exit codes: 0 on success, 1 when a call fails (including a missing GOOGLE_MAPS_API_KEY or an API error), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

bash
npx -y @reneturcios/mapport mcp

MCP client configuration:

json
{  "mcpServers": {    "mapport": {      "command": "npx",      "args": ["-y", "@reneturcios/mapport", "mcp"],      "env": { "GOOGLE_MAPS_API_KEY": "your API key" }    }  }}

Tools

ToolInputWhat it returns
maps_geocodeaddress (string, required)Matching locations with coordinates, formatted address, and place ID.
maps_reverse_geocodelatitude (number, required), longitude (number, required)The nearest address for the coordinates, with its components.
maps_search_placesquery (string, required), location (object, optional), radius (number, optional)Places matching the query, with names, addresses, and locations.
maps_place_detailsplace_id (string, required)Full details for one place: contact info, rating, reviews, and opening hours.
maps_distance_matrixorigins (string[], required), destinations (string[], required), mode (string, optional)A matrix of distances and travel durations.
maps_elevationlocations (array of {latitude, longitude}, required)Elevation in metres for each location.
maps_directionsorigin (string, required), destination (string, required), mode (string, optional)Routes with legs, steps, distance, and duration.

Google reports most API failures inside an HTTP 200 payload, in a top-level status field. mapport surfaces any status other than OK or ZERO_RESULTS as a tool error naming the status and Google's own message; ZERO_RESULTS is returned as an honest empty answer.

Development

bash
npm installnpm run build   # tsc -> dist/npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)npm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.

來源：README.md，提交 d2e2fbf

工具

7

maps_geocode

Convert a street address into geographic coordinates, a formatted address, and a place ID.

輸入參數address必填

maps_reverse_geocode

Convert geographic coordinates into the nearest human-readable address.

輸入參數latitude必填longitude必填

maps_search_places

Search for places matching a text query, optionally centred on a location within a radius.

輸入參數query必填radiuslocation

maps_place_details

Fetch detailed information about one place, including contact details, ratings, and opening hours.

輸入參數place_id必填

maps_distance_matrix

Calculate travel distances and durations between sets of origins and destinations.

輸入參數modeorigins必填destinations必填

maps_elevation

Look up the elevation above sea level for one or more geographic coordinates.

輸入參數locations必填

maps_directions

Get route directions between an origin and a destination, with steps, distance, and duration.

輸入參數modeorigin必填destination必填

版本歷史

1
  1. v0.1.0最新Oct 31, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分