birthday-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@birthday-mcp who has a birthday on July 7?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
名人、历史人物与动漫游戏角色生日库 (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 工具列表
get_birthdays(month=None, day=None, limit=50, categories=None, country=None, occupation=None):查询指定日期的生日人物列表(缺省月日时默认为今天),按热度知名度降序返回前 N 个。get_birthdays_by_category(month=None, day=None, limit_per_category=10, categories=None):按大类分组查询生日人物(缺省月日时默认为今天),每一类(二次元角色、历史人物、现代名人等)各自按热度降序返回前 N 个。search_person(name, limit=20):根据姓名或别名(支持中文、日文、英文、拼音、字号)模糊或精确搜索人物信息。get_person(person_id):获取人物完整多语言名称、生日历法详情、身份标签与来源记录。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-etl3. 运行 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 pytestAvailable Tools
4 toolsget_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
Scored across 4 tools
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.
Three tools follow a get_* pattern, but search_person uses a different verb. This is a minor deviation and remains readable.
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.
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
Related MCP Connectors
Birth charts for agents: BaZi, Chinese and Western zodiac, numerology. Keyless and read-only.
ppl personal CRM: contacts, relationship notes, birthdays and follow-ups for AI agents. Hosted MCP.
Chinese almanac: lunar calendar, BaZi 八字, daily 宜忌, lucky-day picker, public holidays.
Read and search folders on your own computer with explicit consent. Files are never uploaded.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Chinese metaphysics Ba Zi (Four Pillars) birth chart calculation and Huangli (almanac) queries via natural language, with lightweight offline setup.MIT
- AlicenseNot gradedqualityBmaintenanceEnables offline lookup and search of the US civil aircraft registry by N-number, owner, type, or state, returning detailed aircraft and ownership information.602 npm5Apache 2.0
- AlicenseAqualityCmaintenanceEnables 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.131MIT
- AlicenseAqualityCmaintenanceEnables 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.4MIT