Earth

com.mireye由 mireye.com 發布官方發布者v0.7.3更新於 Nov 8, 2026

Mireye Earth: free public geospatial data, parcel enrichment, search, and cited answers.

已驗證Streamable HTTP可網頁執行位置與生活資料與分析

概覽

AI 產生的概覽

Mireye Earth 是託管式 MCP 端點,讓助理取得免費公開地理空間資料、地塊資訊補全、搜尋與附引用的回答。

可以做什麼
  • 依 power、water 等預設欄位包補全地點或符合的地塊,每個欄位含值、來源、信心度與解讀提示
  • 以純量篩選條件搜尋公開地理空間與地塊紀錄,回傳所需欄位、remarks 與分頁游標
  • Fetch 與 Ask 各有獨立回應契約,與 Enrich、Search 不同
  • 搭配的安裝輔助工具可為 Claude Code、Codex 與 Cursor 寫入託管 MCP 設定,並安裝 use-mireye 技能
適用情境
當助理需要附引用的地理空間或地塊層級資訊(例如土地、公用設施或位置屬性),且希望使用託管端點而非本機伺服器時適用。安裝輔助工具用於把支援的程式開發用戶端接上該端點。
執行需求
遠端 streamable HTTP 端點 api.mireye.com,用戶端需 OAuth 登入。選用的輔助工具是透過 uvx 執行的 Python 套件,需要 Mireye 帳號、接受目前客戶條款,並以標準輸入提供受限的安裝 API 金鑰。
安裝前請注意
輔助工具會把受限 API 金鑰存到本機憑證檔並修改用戶端設定檔,但會備份並保留無關項目。Enrich 與 Search 回應含計費資訊,呼叫可能產生費用。doctor 驗證會發出一次免費的 REST Fetch,且不驗證託管 MCP 的 OAuth,登入後需自行確認工具。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Earth,將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.mireye%2Fearth/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "earth": {
      "type": "http",
      "url": "https://api.mireye.com/mcp"
    }
  }
}

README

Mireye hosted MCP setup helper

mireye-mcp 0.7.3 configures Claude Code, Codex and Cursor to connect directly to https://api.mireye.com/mcp, and installs the use-mireye skill. The package runs no MCP server. Its default invocation refuses the retired local stdio transport; device login and local data tools are not included.

Sign in at Mireye agent setup, accept the current customer terms, copy the private setup prompt and paste it into your agent. The prompt supplies the scoped API key through standard input, never a process argument. The helper validates the account and exact setup-key identity before saving the key or changing client configuration.

bash
# The agent supplies the private key on stdin, without echoing or logging it.uvx --from mireye-mcp==0.7.3 mireye-mcp connect --all --api-key-stdin --attempt-id '<attempt-id>' --token-id '<token-id>'uvx --from mireye-mcp==0.7.3 mireye-mcp doctor --proof

connect writes native hosted configurations, without API keys or local launch commands. Restart your agent and authorize its hosted MCP connection using the client's OAuth sign-in. OAuth credentials remain managed by that client.

doctor --proof verifies the installed configuration and skill, checks the saved API key's account, and makes one free REST Fetch for elevation at 40.7128, -74.0060. It requires a finite value, ok status, source URL and timestamp before reporting the data proof. The API records the successful Fetch against the setup attempt. This proves the REST key/data path; it does not authorize or verify hosted MCP OAuth. Confirm the connected client's tools after OAuth sign-in.

Client / purposeConfigurationSkill / credentials
Claude Code~/.claude.json~/.claude/skills/use-mireye/SKILL.md
Codex~/.codex/config.toml~/.agents/skills/use-mireye/SKILL.md
Cursor~/.cursor/mcp.json~/.agents/skills/use-mireye/SKILL.md (shared with Codex)
Helper API key—~/.config/mireye-mcp/credentials.json (mode 0600)
Setup ownership—~/.config/mireye-mcp/onboarding.json

Setup preserves unrelated configuration, refuses custom conflicting entries or modified skills, and backs up changed configuration files. A process lock and content rechecks protect concurrent edits. Repeating connect reuses the saved key and files; it does not issue credentials or grant another promotional balance. An inherited shell key cannot replace an existing managed account. To switch accounts, remove the managed connection, run logout, then connect from that account's setup page. Authorize the correct account separately in the MCP client's OAuth flow.

bash
# Preview only: no key read, API requests, login save, lock or file changes.uvx --from mireye-mcp==0.7.3 mireye-mcp connect --all --dry-run# Reuse the saved key; --client can be repeated.uvx --from mireye-mcp==0.7.3 mireye-mcp connect --client codex# Read a redacted diagnostic report.uvx --from mireye-mcp==0.7.3 mireye-mcp doctor --proof --json# Remove unchanged owned entries/skills, retaining the helper API key.uvx --from mireye-mcp==0.7.3 mireye-mcp connect --all --remove# Remove the helper's saved key. --revoke also revokes its server-verified key ID.uvx --from mireye-mcp==0.7.3 mireye-mcp logout

--all skips absent supported clients; explicitly selecting an absent client fails. Existing identical manual entries remain unmanaged, including on removal. No project instructions or shell profiles are changed. Custom CODEX_HOME and CLAUDE_CONFIG_DIR locations require manual setup; use --config-home PATH for isolated tests. --base-url accepts the production API or loopback only and binds saved keys to that origin. Redirects never forward a key to another host. Legacy --api-key input remains accepted for compatibility; prefer stdin so the key cannot appear in process listings.

Native configurations follow the client documentation: Claude Code, Codex, and Cursor.

The official MCP registry entry is hosted-only. This package is not a local transport distribution, and installing it does not add a second data service.

Enrich results

The hosted mireye_enrich tool returns the same compact response as POST /v1/enrich. Each returned field contains value, source, confidence, and interpretation_hints, with unit only when defined. Failed fields are omitted. A matched parcel can return fields: {}.

Coordinates, geocode evidence, the analysis point, parcel match status and billing are included. mireye_enrich takes preset as a list of one or more bundle names, such as ["power", "water"].

mireye_search returns scalar filter values and every requested public Search or Enrich field as plain values in each match's fields, excluding top-level identity duplicates, using the matched parcel record's lat/lon pair. Every response carries remarks ([] when clean; branch on code and path) and next_cursor (null on the last page). Fetch and Ask have their own contracts. See the Enrich reference for the 525-field inventory, selectors and examples.

來源:README.md,提交 664af58

工具

0
該伺服器需要登入,因此 SourceWeft 無法在沒有帳號的情況下讀取其工具,也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

4
  1. v0.7.3最新Oct 22, 2026
  2. v0.7.2Oct 20, 2026
  3. v0.6.1Oct 20, 2026
  4. v0.5.0Sep 16, 2026

評分

已滿足適用檢查項的 72%

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

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分

    請在註冊中心條目中發布圖示。

  • 文件15 分
  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。