io.github.sincekmori/negirau MCP Server

This MCP server provides read-only, anonymous access to the Negirau public API, exposing subjects and their reaction counts. It is packaged under io.github.sincekmori/negirau and is associated with topics including mcp, openapi, and cloudflare-workers.

🛠️ Key Features

Read-only access to the Negirau public API
Anonymous access
Returns subjects and their reaction counts
Related to OpenAPI (openapi topic)

🚀 Use Cases

Retrieve Negirau subjects
Display or analyze reaction counts for subjects

⚡ Developer Benefits

Aligns with MCP (mcp) for tool integration
Tooling ecosystem mentioned via related packages (npm and PyPI badges in the excerpt)
TypeScript ecosystem indicated by typescript topic

⚠️ Limitations

Read-only (cannot modify data)
Anonymous access (no authenticated usage described)

📌 Topics

agent-skills, appreciation, cloudflare-d1, cloudflare-workers, gratitude, mcp, openapi, qr-code, react-router, typescript

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.

Repository layout

Path

What

License

/ (server + web app)

React Router 7 app on Cloudflare Workers

AGPL-3.0-only

packages/client-ts

TypeScript API client (npm), hand-written + spec contract tests

Apache-2.0

packages/client-py

Python API client (PyPI), hand-written + spec contract tests

Apache-2.0

packages/mcp-server

MCP server (npm), registers tools dynamically from the live spec

Apache-2.0

skills/negirau

Agent Skill (SKILL.md), generated from the route manifest

Apache-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.

Install

Configuration

Environment variables

NEGIRAU_BASE_URL

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "negirau": {
      "command": "npx",
      "args": [
        "-y",
        "negirau-mcp@0.3.2"
      ],
      "env": {
        "NEGIRAU_BASE_URL": "<YOUR_NEGIRAU_BASE_URL>"
      }
    }
  }
}

io.github.sincekmori/negirau