Negirau

io.github.sincekmori由 GitHub 帳號 sincekmori 發布v0.3.3更新於 Nov 8, 2026

Read-only, anonymous access to the Negirau public API: subjects and their reaction counts.

已驗證STDIO僅桌面位置與生活資料與分析

概覽

AI 產生的概覽

以唯讀方式介接 Negirau 公開 API，讓助理查詢對象及其收到的感謝反應計數。

可以做什麼
  • 透過 Negirau 公開 API 查詢對象及其反應計數
  • 依關鍵字在伺服器端搜尋對象，並進行有範圍限制的鄰近搜尋
  • 只取得公開的匿名資料，不涉及帳號或使用者產生的內容
適用情境
當需要讓助理查看某個對象（例如消防隊、活動團隊、線上服務或開源專案）收到的感謝數量，或依名稱、位置尋找這類對象時適用。
執行需求
以本機 stdio 程序執行，從 npm 套件 negirau-mcp 安裝，需要 Node.js。預設呼叫 api.negirau.com 的公開 API，可透過環境變數 NEGIRAU_BASE_URL 改用其他基礎位址。不需帳號或 API 金鑰。
安裝前請注意
此伺服器為唯讀且匿名，不會寫入、傳送或刪除資料。計數依設計有上限：超過 100 會顯示為「100+」，且沒有排名或批次匯出端點，因此不能用於排行榜或完整匯出。設定 NEGIRAU_BASE_URL 會把請求導向其他主機，請只改為你信任的位址。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

Negirau

[CI] [License] [npm negirau] [npm negirau-mcp] [PyPI negirau] [Negirau]

日頃の担い手に、ねぎらいを。 Negirau (negirau.com) lets anyone send a one-tap, login-free appreciation to the people behind everyday work — fire stations, event crews, online services, open-source maintainers.

  • No accounts, no user-generated text, no visitor data stored.
  • Counts are shown exactly up to 100 and as "100+" beyond — by design, this service cannot become a ranking.
  • Runs entirely on Cloudflare Workers + D1 within the free tier.

Development

Prerequisites: bun (plus pnpm for packages/client-ts and packages/mcp-server, and uv for packages/client-py).

bun installcp .dev.vars.example .dev.varsbun run db:migrate && bun run db:seedbun run dev

See AGENTS.md for the full check list, architecture invariants, and gotchas.

Repository layout

PathWhatLicense
/ (server + web app)React Router 7 app on Cloudflare WorkersAGPL-3.0-only
packages/client-tsTypeScript API client (npm), hand-written + spec contract testsApache-2.0
packages/client-pyPython API client (PyPI), hand-written + spec contract testsApache-2.0
packages/mcp-serverMCP server (npm), registers tools dynamically from the live specApache-2.0
skills/negirauAgent Skill (SKILL.md), generated from the route manifestApache-2.0

Everything under packages/ is held to the OpenAPI spec: both clients run spec-driven contract tests, mcp-server reads the live spec at startup, and SKILL.md is generated with a CI drift gate.

Public API

Read-only, anonymous, CORS-open, based at https://api.negirau.com/v1. The spec is served at /v1/openapi.json and generated from the zod schemas at build time — it cannot drift from the implementation. There are no bulk dumps and no ranking endpoints, on purpose: the lookup path is server-side search (q= on /v1/subjects) and bounded nearby search.

License

Copyright (C) 2026 Shinsuke Mori.

The server and web app are licensed under AGPL-3.0-only. Client packages under packages/ are licensed under Apache-2.0 (see each package's LICENSE). The "Negirau" name and the heart-pin logo are not covered by these licenses.

Attribution

來源：README.md，提交 35fd411

工具

3

negirau_list_subjects

Search Negirau subjects (the recipients of appreciation). Use q for name search, near='lat,lng' for proximity search. Cursor-paginated subject listing. `q` does free-text name search (Japanese and English): 1-2 characters match as a name prefix (single page), 3 or more match anywhere in the name. With `near`, switches to a distance-ordered search over subjects that have a spatial dimension (no cursor; results truncated at `limit`; a `q` sent alongside is ignored).

輸入參數qnearlimitcursorradius

negirau_get_subject

Fetch one Negirau subject by id. A single subject by its public identifier.

輸入參數id必填

negirau_get_reactions

All-time reaction display values for a Negirau subject. All-time total and per-type reaction display values for one subject. Values are exact up to 100 and capped at "100+" beyond.

輸入參數id必填

版本歷史

2
  1. v0.3.3最新Nov 7, 2026
  2. v0.3.2Sep 16, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分