Skip to main content
Glama
birthday-mcp
by one-ade

名人、历史人物与动漫游戏角色生日库 (birthday-mcp)

一个完全本地化、零公网依赖的高性能生日知识库与 FastMCP 服务,专为 Hermes 及各类 Agent 和本地用户设计。

核心特性

  • 完全本地化:查询全程运行于本地 SQLite (data/birthday.db),正常查询过程中不访问任何公网服务。

  • 全方位覆盖:

    • 动漫角色、漫画角色、游戏角色、Galgame / VN 角色(CharacterDB / Bangumi / VNDB)

    • 声优、作者、导演等现实创作者人物

    • 中国历史人物(CBDB 中国历代人物传记数据库)

    • 全球知名人物与世界历史人物(Pantheon 2025 / HPI)

    • 中国现代知名人物(院士、学者、作家、演员、歌手、运动员等补充库)

  • 高性能架构:

    • DuckDB 用于离线海量数据清洗、多源 Join 与三级去重。

    • SQLite 配备专用的 birthday_index 覆盖索引,单次查询毫秒级返回。

    • FastMCP 规范暴露 4 个轻量易用的语义工具。

Related MCP server: @cyanheads/faa-aircraft-registry-mcp-server

MCP 工具列表

  1. get_birthdays(month=None, day=None, limit=50, categories=None, country=None, occupation=None):查询指定日期的生日人物列表(缺省月日时默认为今天),按热度知名度降序返回前 N 个。

  2. get_birthdays_by_category(month=None, day=None, limit_per_category=10, categories=None):按大类分组查询生日人物(缺省月日时默认为今天),每一类(二次元角色、历史人物、现代名人等)各自按热度降序返回前 N 个。

  3. search_person(name, limit=20):根据姓名或别名(支持中文、日文、英文、拼音、字号)模糊或精确搜索人物信息。

  4. get_person(person_id):获取人物完整多语言名称、生日历法详情、身份标签与来源记录。

  5. get_upcoming_birthdays(days=7, limit_per_day=20, categories=None):获取今天起未来 N 天内的即将生日人物。

快速上手

1. 安装与初始化

# 使用 uv 创建虚拟环境并安装依赖
uv venv --python 3.12
uv pip install -e .[dev]

2. 构建本地数据库

# 运行 ETL 构建管道 (生成 data/birthday.db)
uv run birthday-etl

3. 运行 FastMCP 服务

# 启动标准 stdio MCP 服务
uv run birthday-mcp

在 Hermes 或 Claude Desktop 配置中加入:

{
  "mcpServers": {
    "birthday": {
      "command": "d:/dev-code/BirthdayAll/.venv/Scripts/python.exe",
      "args": ["-m", "app.main"]
    }
  }
}

4. 运行测试套件

uv run pytest

Available Tools

4 tools
get_birthdaysGet BirthdaysA

Query celebrities, historical figures, and anime/game characters born on a specific month and day.

Inputs: day (required), month (required), limit, country, +2 more. Returns: result

get_personGet PersonB

Get complete biographical details, all alias names, full birthday records, and source lineage for a specific person ID.

Inputs: person_id (required). Returns: result

get_upcoming_birthdaysGet Upcoming BirthdaysC

Get persons celebrating birthdays in the upcoming N days starting from today.

Inputs: days, categories, limit_per_day. Returns: object

search_personSearch PersonC

Search for a celebrity, historical figure, or anime/game character by name or alias.

Inputs: name (required), limit. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a distinct purpose: upcoming birthdays, name search, detailed profile via ID, and birthdays on a specific date. There is no overlap in query type or resource.

    Naming Consistency4/5

    Three tools follow a get_* pattern, but search_person uses a different verb. This is a minor deviation and remains readable.

    Tool Count4/5

    With only 4 tools, the surface is lean but covers the core birthday lookup needs. It is slightly under what a full-featured birthday service might offer, but reasonable for the scope.

    Completeness4/5

    The tools cover upcoming birthdays, date-specific birthdays, name search, and detailed profiles. However, there is no way to list all people or filter by category, which might be a minor gap.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables Chinese metaphysics Ba Zi (Four Pillars) birth chart calculation and Huangli (almanac) queries via natural language, with lightweight offline setup.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables offline, fully local lookups and validations tuned for Chinese development work: statutory holiday and adjusted-workday checks, workday arithmetic, ID card/USCC/mobile format validation, Chinese-to-pinyin conversion, lunar-solar date conversion, and administrative region queries. It also provides searchable summaries of common uni-app, mini program, Element Plus, and Vant APIs, so assistants can answer these questions without any network calls or third-party services.
      13
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables offline King James Version Bible lookup, passage retrieval, word and phrase search, deterministic verse-of-the-day access, and book/chapter listing for AI assistants. All tools are read-only and return citable references with structured JSON.
      4
      MIT