negirau

Name: negirau
Author: sincekmori

本地服务

github.com/sincekmori社交媒体08 周前更新

代码仓库

关于 negirau

Negirau 提供公开服务，可匿名查询日常工作背后个人和团体收到的感谢次数。其 API 仅支持读取，并刻意不提供排名和批量数据导出。

主要功能

01匿名只读公共 API
02按查询词搜索对象
03限定范围的附近搜索
04感谢次数超过 100 显示为 100+

适用场景

01查询公共服务收到的感谢
02按名称或关键词查找对象
03查看附近对象及其次数

MCP 相关

项目包含 MCP 服务，会根据实时 API 规范动态注册工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y negirau-mcp

需要配置的环境变量

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

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmnegirau-mcp0.3.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Negirau

向日常工作的幕后付出者，表达感谢。 Negirau (negirau.com) 让任何人都能一键向日常工作背后的付出者表达感谢，无需登录——消防站、活动工作人员、在线服务以及开源项目维护者。

无需账户，不接受用户生成的文本，也不存储访客数据。
计数最多精确显示到 100，超过则显示为“100+”——这是刻意设计的，因此本服务不可能演变成排行榜。
完全在 Cloudflare Workers + D1 上运行，且使用量处于免费额度内。

开发

前置条件：bun（另外，packages/client-ts 和 packages/mcp-server 需要 pnpm，packages/client-py 需要 uv）。

bun install
cp .dev.vars.example .dev.vars
bun run db:migrate && bun run db:seed
bun run dev

完整的检查清单、架构约束和注意事项请参阅 AGENTS.md。

仓库布局

路径	内容	许可证
`/`（服务端 + Web 应用）	运行于 Cloudflare Workers 上的 React Router 7 应用	AGPL-3.0-only
`packages/client-ts`	TypeScript API 客户端（npm），手写测试 + 规范契约测试	Apache-2.0
`packages/client-py`	Python API 客户端（PyPI），手写测试 + 规范契约测试	Apache-2.0
`packages/mcp-server`	MCP 服务（npm），根据实时规范动态注册工具	Apache-2.0
`skills/negirau`	Agent Skill（SKILL.md），由路由清单生成	Apache-2.0

packages/ 下的所有内容都遵循 OpenAPI 规范：两个客户端都会运行规范驱动的契约测试，mcp-server 会在启动时读取实时规范，而 SKILL.md 则由 CI 漂移检查门禁生成。

公共 API

只读、匿名、开放 CORS，基地址为 https://api.negirau.com/v1。规范位于 /v1/openapi.json，并在构建时根据 zod schema 生成——不会与实际实现产生偏差。有意不提供批量数据导出和排行榜端点：查询通过服务端搜索实现（在 /v1/subjects 上使用 q=），并提供范围受限的附近搜索。