
Pondlog Mushroom Observer
io.github.andrewschristison由 GitHub 帳號 andrewschristison 發布v0.1.6-1更新於 Oct 24, 2026
Mushroom Observer MCP server. Mycology observations, fungal taxonomy, and region discovery.
概覽
一個本機 MCP 伺服器,讓助理存取 Mushroom Observer 的真菌觀察紀錄、真菌分類學,以及依地區探索觀察資料。
- 可以做什麼
- 查詢 Mushroom Observer 的真菌學觀察紀錄,包括真菌被記錄的地點與時間;此伺服器屬於 Pondlog 自然資料系列,提供五個以真菌學為先的工具。探索真菌分類學,並依地區探索觀察紀錄。伺服器是帶型別驗證與限流的 Mushroom Observer 用戶端之上的輕量封裝,請求在送達公開 API 前會被限流與驗證。
- 適用情境
- 適合讓助理回答某地區蘑菇及其他真菌的觀察紀錄問題,或在對話中查詢真菌分類與觀察資料。它是 Pondlog 系列中的單一資料來源,因此當重點是真菌學而非一般野生動物或賞鳥時選用它。
- 執行需求
- 以 stdio 本機程序執行,例如透過 npm 套件以 npx 啟動。不需要 API 金鑰:README 將 Mushroom Observer 列為免金鑰資料來源。需要能連線至 Mushroom Observer 公開 API 的網路。清單標示為僅限桌面端。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Pondlog Mushroom Observer,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
pondlog
Place-aware nature data for developers. What's happening in nature at these coordinates right now?
Pondlog stitches together free public APIs (iNaturalist, eBird, USA-NPN,
USGS, Mushroom Observer) plus local astronomy computation
(astronomy-engine) and NOAA tides/cloud cover into one data layer
with two interfaces:
- A CLI for humans (
pondlog inat nearby --lat 48.118 --lng -123.43) - An MCP server per source for AI agents (Claude Desktop, Cursor)
What's in the box
8 data sources. 7 MCP servers. 1 unified CLI. A ~1000-crop garden planner with USDA hardiness zones and companion-planting graph.
Status
Quick start
As an AI agent (MCP)
Add to your Claude Desktop config
(~/Library/Application Support/Claude/claude_desktop_config.json on
macOS):
Then ask Claude:
What amphibians have been seen near Port Angeles, WA in the last week?
The same JSON works in ~/.cursor/mcp.json for Cursor. Run any MCP
server in one command:
As a human (CLI)
--json works on every command for machine output.
Architecture
Source clients do all the work (Zod validation, rate limiting, retry, normalization). The CLI and MCP servers are thin wrappers around them.
Design principles
- One data layer, two interfaces. Each source is a typed library
(Zod-validated, rate-limited, returns
Result<T>). The CLI and MCP servers are thin wrappers. No business logic in them. - Degrade gracefully. When a source is down, the aggregate still returns whatever else worked, with errors reported in-band.
- Rate limits respected. Each client throttles itself. Never trust the caller.
- No keys for what doesn't need them. iNaturalist, NPN, USGS, Mushroom Observer, and the night-sky source all run keyless. Only eBird and Trefle require free keys.
- Local computation when the data isn't external. Astronomy is
pure math;
@pondlog/source-nightskyships zero network calls, zero rate limits, zero failure modes. The garden calendar, zones, and companion graph are bundled JSON, all offline.
Related: CropGraph
CropGraph is a sibling HTTP API exposing
the same ~1000-crop planting calendar, USDA hardiness zones, and
companion-planting graph used by @pondlog/core and @pondlog/mcp-garden.
Use CropGraph when you want the data over HTTP from any language. The
schemas are kept in lockstep with this repo.
Contributing
PRs welcome. The build is pnpm-based:
Crop calendar / companion-planting data
The crop calendar (packages/core/src/data/crop-calendar.json) and
companion graph (packages/core/src/data/companions.json) accept
community PRs. Both have JSON Schemas alongside the data:
packages/core/src/data/crop-calendar.schema.jsonpackages/core/src/data/companions.schema.json
When adding a crop entry, include a per-entry source citing a real
extension service (USDA, Cornell, WSU, Oregon State, UMass, UF/IFAS,
etc.). When adding a companion edge, include evidence (strong or
moderate) and a citation URL. Zod validation runs at module load,
so a malformed PR breaks import "@pondlog/core" immediately.
Code
Each package follows a strict pattern documented in
docs/METHODOLOGY.md. Source clients always
ship before the CLI commands or MCP tools that consume them.
License
MIT. See LICENSE.
來源:README.md,提交 049fdf4
工具
0版本歷史
2- v0.1.6-1最新Oct 9, 2026
- v0.1.5Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分