English Français العربية

io.github.sincekmori/negirau

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

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

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

التثبيت

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

NPM package negirau-mcp
Claude Code 
claude mcp add negirau -e 'NEGIRAU_BASE_URL=<NEGIRAU_BASE_URL>' -- npx -y negirau-mcp@0.3.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "negirau": {
            "command": "npx",
            "args": [
                "-y",
                "negirau-mcp@0.3.2"
            ],
            "env": {
                "NEGIRAU_BASE_URL": "<NEGIRAU_BASE_URL>"
            }
        }
    }
}

متغيرات البيئة

  • NEGIRAU_BASE_URL Override the API base URL (default https://api.negirau.com/v1)

التوثيق

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

المحتويات
  1. Negirau
  2. Development
  3. Repository layout
  4. Public API
  5. License
  6. Attribution

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 install
cp .dev.vars.example .dev.vars
bun run db:migrate && bun run db:seed
bun 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

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

ما هو io.github.sincekmori/negirau؟

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

كيف أثبّت io.github.sincekmori/negirau؟

يعمل على جهازك. في Claude Code: claude mcp add negirau -e 'NEGIRAU_BASE_URL=<NEGIRAU_BASE_URL>' -- npx -y negirau-mcp@0.3.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.sincekmori/negirau إلى مفتاح API؟

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

هل io.github.sincekmori/negirau مفتوح المصدر؟

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

من يصون io.github.sincekmori/negirau؟

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

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