Japan Business Tools
Japanese holidays, business days, eras, postal codes, addresses and corporate numbers.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"jp-biz-tools": {
"url": "https://biz.ossalt.jp/mcp"
}
}
}远程端点
https://biz.ossalt.jp/mcpstreamable-http它能做什么
工具清单
工具(13)
🟢list_holidays(year)
List all Japanese national holidays and substitute holidays for a year, based on the National Holidays Act and verified against the Cabinet Office CSV. Each holiday has `name` (descriptive) and `official_name` (as written by the Cabinet Office). / その年の国民の祝日・休日(振替休日・国民の休日を含む)の一覧。name は内容がわかる名前、official_name は内閣府の表記。
输入模式
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 1980,
"maximum": 2099,
"description": "Year (1980-2099) / 年"
}
},
"required": [
"year"
],
"additionalProperties": false
}🟢check_business_day(date, calendar, extra_holidays, extra_business_days)
Check whether a date is a business day in Japan, and if not, why (weekend, holiday name, bank closure, or a custom closed day). `reason` is Japanese text; `reason_code` is one of weekend, holiday, bank_closure, extra_holiday (null on business days). flags: `estimated`/`unverified` when the year's holidays are an estimate. / その日が営業日かどうかと、休みの理由(土日・祝日の名前・銀行の休業日・指定された休日)。reason_code は weekend・holiday・bank_closure・extra_holiday。
输入模式
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date (YYYY-MM-DD) / 日付",
"maxLength": 200
},
"calendar": {
"type": "string",
"enum": [
"standard",
"bank"
],
"default": "standard",
"description": "\"standard\": weekends and national holidays are closed. \"bank\": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日)",
"maxLength": 200
},
"extra_holidays": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD"
},
"maxItems": 366,
"description": "Additional company-specific closed days (e.g. summer break). / 会社独自の休み"
},
"extra_business_days": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD"
},
"maxItems": 366,
"description": "Days treated as business days even if they are weekends or holidays. / 休日でも営業日とする日"
}
},
"required": [
"date"
],
"additionalProperties": false
}🟢add_business_days(date, days, calendar, extra_holidays, extra_business_days)
Return the date that is N business days after (or before, if N is negative) the given date. The start date itself is not counted; e.g. 1 business day after a Friday is the next Monday unless it is a holiday. / n営業日後(nが負なら前)の日付。起算日は数えない。
输入模式
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date (YYYY-MM-DD) / 起算日",
"maxLength": 200
},
"days": {
"type": "integer",
"minimum": -2000,
"maximum": 2000,
"description": "Number of business days (negative = before) / 営業日の数(負なら前)"
},
"calendar": {
"type": "string",
"enum": [
"standard",
"bank"
],
"default": "standard",
"description": "\"standard\": weekends and national holidays are closed. \"bank\": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日)",
"maxLength": 200
},
"extra_holidays": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD"
},
"maxItems": 366,
"description": "Additional company-specific closed days (e.g. summer break). / 会社独自の休み"
},
"extra_business_days": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD"
},
"maxItems": 366,
"description": "Days treated as business days even if they are weekends or holidays. / 休日でも営業日とする日"
}
},
"required": [
"date",
"days"
],
"additionalProperties": false
}🟢count_business_days(start, end, calendar, extra_holidays, extra_business_days)
Count business days from start to end, inclusive of both ends. Returns 0 if start is after end. The period can be up to 3,660 days (about 10 years). / start から end までの営業日の数(両端を含む)。start が end より後なら 0。期間は3,660日(約10年)まで。
输入模式
{
"type": "object",
"properties": {
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date (YYYY-MM-DD) / 開始日",
"maxLength": 200
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date (YYYY-MM-DD) / 終了日",
"maxLength": 200
},
"calendar": {
"type": "string",
"enum": [
"standard",
"bank"
],
"default": "standard",
"description": "\"standard\": weekends and national holidays are closed. \"bank\": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日)",
"maxLength": 200
},
"extra_holidays": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD"
},
"maxItems": 366,
"description": "Additional company-specific closed days (e.g. summer break). / 会社独自の休み"
},
"extra_business_days": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD"
},
"maxItems": 366,
"description": "Days treated as business days even if they are weekends or holidays. / 休日でも営業日とする日"
}
},
"required": [
"start",
"end"
],
"additionalProperties": false
}🟢adjust_to_business_day(date, direction, calendar, extra_holidays, extra_business_days)
If the date is a business day, return it as is; otherwise move to the next ("next") or previous ("previous") business day. Useful for payment due dates that fall on holidays. / 営業日ならその日、休みなら次(next)または前(previous)の営業日。支払日が休みのときなどに使う。
输入模式
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date (YYYY-MM-DD) / 日付",
"maxLength": 200
},
"direction": {
"type": "string",
"enum": [
"next",
"previous"
],
"default": "next",
"description": "next = 後ろ倒し, previous = 前倒し",
"maxLength": 200
},
"calendar": {
"type": "string",
"enum": [
"standard",
"bank"
],
"default": "standard",
"description": "\"standard\": weekends and national holidays are closed. \"bank\": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日)",
"maxLength": 200
},
"extra_holidays": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD"
},
"maxItems": 366,
"description": "Additional company-specific closed days (e.g. summer break). / 会社独自の休み"
},
"extra_business_days": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD"
},
"maxItems": 366,
"description": "Days treated as business days even if they are weekends or holidays. / 休日でも営業日とする日"
}
},
"required": [
"date"
],
"additionalProperties": false
}🟢last_business_day_of_month(year, month, calendar, extra_holidays, extra_business_days)
Return the last business day of the given month. / その月の最終営業日。
输入模式
{
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 1980,
"maximum": 2099,
"description": "Year (1980-2099) / 年"
},
"month": {
"type": "integer",
"minimum": 1,
"maximum": 12,
"description": "Month (1-12) / 月"
},
"calendar": {
"type": "string",
"enum": [
"standard",
"bank"
],
"default": "standard",
"description": "\"standard\": weekends and national holidays are closed. \"bank\": also closed Dec 31 - Jan 3 (Japanese bank holidays). / standard:土日・祝日が休み。bank:加えて12月31日〜1月3日が休み(銀行の休業日)",
"maxLength": 200
},
"extra_holidays": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD"
},
"maxItems": 366,
"description": "Additional company-specific closed days (e.g. summer break). / 会社独自の休み"
},
"extra_business_days": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD"
},
"maxItems": 366,
"description": "Days treated as business days even if they are weekends or holidays. / 休日でも営業日とする日"
}
},
"required": [
"year",
"month"
],
"additionalProperties": false
}🟢to_japanese_era(date)
Convert a Gregorian date (YYYY-MM-DD) to the Japanese era calendar, e.g. 2026-10-07 → 令和8年10月7日 (wareki_short R8.10.07, zero-padded). Year 1 is written 元年. Supported from 1873-01-01 (the Gregorian calendar was adopted on 明治6年1月1日). Eras: 令和 (R) from 2019-05-01, 平成 (H) from 1989-01-08, 昭和 (S) from 1926-12-25, 大正 (T) from 1912-07-30, 明治 (M) from 1868-01-25. flags: `assumes_current_era` for dates after today (the era might change). / 西暦の日付を和暦にする。1年目は「元年」。明治6年(1873年)1月1日から。今日より後の日付には assumes_current_era。
输入模式
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date (YYYY-MM-DD) / 日付",
"maxLength": 200
}
},
"required": [
"date"
],
"additionalProperties": false
}🟢from_japanese_era(wareki)
Convert a Japanese era date to YYYY-MM-DD. Accepts 令和8年10月7日, 令和元年5月1日, R8.10.7, H31/4/30, Reiwa 8.10.7, kanji numerals (昭和六十四年一月七日), a trailing weekday such as (水) or 水曜日, and full-width characters. `input_era`/`input_era_year` echo the input; `actual` is the correct era for that date. If the date is outside the input era (e.g. 平成31年5月1日, written after the era changed), it is still converted by counting years, `within_era` is false and flags has `outside_era`. If a weekday was given and does not match, `weekday_matches` is false and flags has `weekday_mismatch`. / 和暦の日付を西暦にする。元号の範囲の外(平成31年5月1日など)も年を数えて変換し、within_era が false・flags に outside_era。曜日が合わなければ weekday_mismatch。
输入模式
{
"type": "object",
"properties": {
"wareki": {
"type": "string",
"description": "Japanese era date, e.g. 令和8年10月7日 or R8.10.7 / 和暦の日付",
"maxLength": 200
}
},
"required": [
"wareki"
],
"additionalProperties": false
}🟢lookup_postal_code(postal_code)
Look up the address (prefecture, city, town) for a 7-digit Japanese postal code, from Japan Post data. Accepts forms like 1000001, 100-0001 or 〒100-0001. One code can cover several towns; all are returned. `town_detail` holds the parenthesized part as written by Japan Post (e.g. chome ranges or building floors). If the code is a business-specific code (大口事業所個別番号) or a PO box code, the business is returned in `offices`. / 郵便番号から住所(都道府県・市区町村・町域)。日本郵便のデータ。1つの郵便番号に町域が複数あれば、すべて返す。事業所の個別郵便番号なら、事業所名と所在地を offices に返す。
输入模式
{
"type": "object",
"properties": {
"postal_code": {
"type": "string",
"description": "7-digit postal code, hyphen optional / 郵便番号(7桁、ハイフンは任意)",
"maxLength": 200
}
},
"required": [
"postal_code"
],
"additionalProperties": false
}🟢search_postal_code(prefecture, city, town, office_name)
Find Japanese postal codes by prefecture, city and (optionally) part of the town name, from Japan Post data. The city must be the full municipality name (e.g. 札幌市中央区, 新宿区); the county name may be omitted. With `office_name`, searches business-specific codes (大口事業所個別番号) of businesses in that city by name instead. Returns up to 100 matches. / 都道府県・市区町村・町域(部分一致、任意)から郵便番号を探す。市区町村は正式な名前で(郡名は省いてよい)。office_name を指定すると、その市区町村の事業所の個別郵便番号を事業所名(部分一致)で探す。
输入模式
{
"type": "object",
"properties": {
"prefecture": {
"type": "string",
"description": "Prefecture, e.g. 東京都 (optional) / 都道府県(任意)",
"maxLength": 200
},
"city": {
"type": "string",
"description": "Municipality, e.g. 新宿区 / 市区町村",
"maxLength": 200
},
"town": {
"type": "string",
"description": "Part of the town name, e.g. 西新宿 (optional) / 町域の一部(任意)",
"maxLength": 200
},
"office_name": {
"type": "string",
"description": "Part of a business name, in kanji or katakana (optional) / 事業所名の一部(任意)",
"maxLength": 200
}
},
"required": [
"city"
],
"additionalProperties": false
}🟢normalize_address(address)
Split a Japanese address into prefecture, city, town and the rest (block numbers, building), matching Japan Post's address data, and return candidate postal codes. Absorbs full/half-width, spacing, kanji vs. arabic numerals, ヶ/ケ and omitted county names; fills in the prefecture when the city is unique. Does NOT verify block/house numbers and has no coordinates. `level` tells how far the match went: 0 = nothing matched, 1 = prefecture only (see `city_candidates` if the city name is ambiguous), 2 = city matched but not the town (`postal_codes` are city-wide candidates), 3 = town matched. `address` and `municipality_code` are null below level 2. flags: `partial` (level below 3), `ambiguous` (several city or postal code candidates — ask the user or show all). / 住所を都道府県・市区町村・町域・残り(番地・建物名など)に分け、郵便番号の候補を返す(日本郵便のデータにあてはめる)。番地が実在するかの確認と緯度・経度はない。level:0=わからない、1=都道府県まで、2=市区町村まで(町域はわからない)、3=町域まで。
输入模式
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "Japanese address, e.g. 北海道札幌市中央区大通西10丁目1-1 / 住所",
"maxLength": 200
}
},
"required": [
"address"
],
"additionalProperties": false
}🟢lookup_corporate_number(corporate_number)
Look up a 13-digit Japanese corporate number (法人番号) in the National Tax Agency's monthly bulk data: name, furigana, English name, kind, registered address and postal code, assignment date, and closure (date, cause, successor) if the registry record was closed. The check digit (first digit) is verified first; a wrong check digit is reported as an input error. flags: `closed` (the registry record is closed — tell the user), `excluded_from_search`, `not_found`. This is not the invoice (qualified invoice issuer) registry. / 法人番号(13桁)から、名前・フリガナ・英語の名前・法人の種類・所在地・郵便番号・指定の日・閉鎖の日と事由・承継先を返す。国税庁の全件データ(月1回)。先頭の1桁(チェックデジット)を確かめ、合わなければ入力の誤りとして返す。インボイス(適格請求書発行事業者)の登録の確認ではない。
输入模式
{
"type": "object",
"properties": {
"corporate_number": {
"type": "string",
"description": "13-digit corporate number, hyphens/spaces allowed / 法人番号(13桁。ハイフン・空白は任意)",
"maxLength": 200
}
},
"required": [
"corporate_number"
],
"additionalProperties": false
}🟢search_corporation_by_name(name, prefecture)
Find Japanese corporations whose name starts with the given text (prefix match), in the National Tax Agency's monthly bulk data. Legal-form words such as 株式会社 or 一般社団法人 are ignored at either end, and full/half-width and spaces are normalized. Matching in the middle of a name and furigana search are not supported. flags: `truncated`, `exact_match_only` (too many names start with the input; only exact matches returned), `not_found`. Returns up to 100 matches (`total`, `returned`, `truncated`) with corporate number, name, prefecture, city and `is_closed` (registry record closed); use lookup_corporate_number for details. Corporations marked as excluded from search on the NTA site are not included. / 名前の先頭から合う法人を探す(前方一致)。株式会社などの言葉は前後どちらにあっても無視し、全角・半角や空白の違いも吸収する。名前の途中からの検索とフリガナの検索はできない。最大100件。詳しい情報は lookup_corporate_number で。国税庁のサイトで検索対象除外の法人は入っていない。
输入模式
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Beginning of the corporate name (e.g. トヨタ自動車) / 法人の名前の先頭(例:トヨタ自動車)",
"maxLength": 200
},
"prefecture": {
"type": "string",
"description": "Prefecture to narrow down (optional, e.g. 東京都 or 東京) / 都道府県で絞り込む(任意)",
"maxLength": 200
}
},
"required": [
"name"
],
"additionalProperties": false
}社区
证据