MCP サーバー
元号くんの API を Model Context Protocol (MCP) サーバーとして公開しています。Claude Desktop や Claude Code などの AI ホストにインストールすれば、西暦・和暦・祝日のデータを自然言語で問い合わせられます。
deployed_code
パッケージ
`@matsubokkuri/seireki-mcp` を npm に公開しています。Node.js 20 以上が必要です。
@matsubokkuri/seireki-mcp
terminal
インストール
グローバルにインストールするか、`npx` でその都度実行できます。
npm install -g @matsubokkuri/seireki-mcp
# or run on demand
npx -y @matsubokkuri/seireki-mcpクライアント設定
Claude Desktop の `claude_desktop_config.json`、または Claude Code の `.mcp.json` に以下を追記してください。
{
"mcpServers": {
"seireki": {
"command": "npx",
"args": ["-y", "@matsubokkuri/seireki-mcp"]
}
}
}
ベース URL の上書き
ステージング環境などへ向けたいときは `SEIREKI_API_BASE_URL` 環境変数を設定します。
{
"mcpServers": {
"seireki": {
"command": "npx",
"args": ["-y", "@matsubokkuri/seireki-mcp"],
"env": {
"SEIREKI_API_BASE_URL": "https://staging.seireki.example.com"
}
}
}
}
提供ツール
サーバーは以下の 7 ツールを公開します。引数は JSON-Schema として MCP ホストへ提示されます。
| ツール名 | 機能 |
|---|---|
convert_seireki_to_wareki
|
西暦の年を和暦・年齢・干支に変換します。 |
convert_wareki_to_seireki
|
和暦として解釈した年を西暦に変換します。 |
list_seireki_years
|
西暦→和暦の対応表（1〜3000年）を取得します。 |
list_wareki_years
|
和暦→西暦の対応表を取得します。 |
get_holidays
|
指定年の祝日一覧を取得します（1970年以降）。 |
list_holiday_years
|
年ごとの祝日件数サマリを取得します。 |
get_holidays_ics
|
指定年の祝日を iCalendar (.ics) 形式で取得します。 |
開発・ソースコード
実装は本リポジトリの `packages/mcp/` 配下にあります。