Business Days & SLA

business-days-mcp

サポート、請求、運用チームが実際に行う日付計算に対応する MCP サーバーです。今日は営業日か、SLA の期限はいつか、銀行休業日の後の次の営業日はいつかといった疑問に答えます。同じ業務の定期実行に関連する cron と繰り返しルールの解析にも対応します。

オフラインで動作します。ネットワークへの呼び出しも、保存データも、モデルへの呼び出しもありません。すべての回答は、同梱された祝日ルールに基づいて計算されます。

できること

営業日と SLA — holidays パッケージを使用し、約 150 か国とその地域区分に対応した祝日判定ができます（イングランドとスコットランドでは異なり、米国の州ごとにも異なります）。

ツール	回答する内容
is_business_day	この日は営業日ですか？営業日でない場合、週末ですか、それとも名称のある祝日ですか？
next_business_day / previous_business_day	ある日付の次／前の営業日
add_business_days	ある日付から営業日を ±N 日進める
business_days_between	2 つの日付の間にある営業日数（半開区間）
first_business_day_of_month / last_business_day_of_month	月の最初／最後の営業日
sla_due_time	営業時間のみをカウントした場合、N 営業時間の SLA の期限はいつですか？

Cron と繰り返しルール — 解析のみ。 スケジュールの設定、保存、実行は行いません。タイマーもジョブストアもありません。スケジュールに従って何かを実行したい場合、このツールは意図的にその用途には対応していません。

ツール	回答する内容
validate_cron_expression / explain_cron_expression	この cron は有効ですか？英語ではどのような意味ですか？
next_cron_occurrences	次に実行されるのはいつですか？
validate_recurrence_rule / explain_recurrence_rule	RFC 5545 RRULE の場合も同様です
next_recurrence_occurrences	RRULE を展開し、次の実行日時を取得します

インストールと実行

ホスト型エンドポイントはインストール不要です。クライアント設定を参照してください。自分で実行する場合は、uvx が取得して実行します。

uvx --from git+https://github.com/Vessark/business-days-mcp business-days-mcp

クローンから実行する場合：

git clone https://github.com/Vessark/business-days-mcp
cd business-days-mcp
uv sync && uv run business-days-mcp
uv run pytest                         # the tests are the documentation

クライアント設定

ホスト型 — インストール不要

最も手軽に利用できます。同じツールを、インストールも認証情報も不要で使えます。

{
  "mcpServers": {
    "vessark": {
      "url": "https://vessark.com/mcp"
    }
  }
}

自分で実行する

他者の稼働状況に依存したくない場合は、ローカルで実行してください。同じコードで、ネットワークには一切接続しません。

{
  "mcpServers": {
    "business-days": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Vessark/business-days-mcp",
        "business-days-mcp"
      ]
    }
  }
}

使用例

// is_business_day — 2026-12-28, UK
{"date": "2026-12-28", "country": "GB"}
→ {"is_business_day": false, "reason": "holiday: Boxing Day (substitute day)"}

// sla_due_time — 8 business hours from Monday 16:00
{"start": "2026-07-27T16:00", "business_hours": 8}
→ {"due": "2026-07-28T16:00:00", "started_within_business_hours": true}

// explain_cron_expression
{"expression": "30 9 * * MON-FRI"}
→ {"explanation": "At 09:30, on Monday through Friday."}

設計上の注意点

すべてのツールは引数だけを入力とする純粋関数です。そのため、テストスイートの大半はテーブル形式になっています。無効な入力は通常の型付き結果として返され、例外にはなりません。引数を間違えたモデルには、わかりやすい理由が返され、自力で修正できます。呼び出し元が影響を与えられるすべてのループには上限が設けられているため、リクエストによって高コストな計算が発生することはありません。エラーメッセージに送信内容がそのまま含まれることはないため、このサーバーを使って他者のエージェントにテキストを中継することはできません。

既知の制限についても隠さずに記載します。営業週は月曜日から金曜日までと想定しているため、日曜日から木曜日までが週の国では、この前提により正しく判定されません。祝日データは基盤となるデータセットが対応する年のみを対象とします。その範囲外の日付は、通常の営業日として誤って回答するのではなく、拒否されます。

先行プロジェクト

fbdo/business-day-mcp は営業日と祝日の計算に対応しており、このサーバーより先に公開されています。それだけで要件を満たすなら、そちらをお使いください。このサーバーにはない、タイムゾーンを考慮した「今日」の判定や祝日一覧の表示にも対応しています。

このサーバーは、異なる用途を中心に開発されました。営業時間のみをカウントする SLA の期限計算と、同じ業務の定期実行に関する cron / RRULE の解析です。営業日のツールには実際に重複があり、名称も一般的なものを使っています。どちらのサーバーも MIT ライセンスで、優れた holidays パッケージを基盤としています。

リリース

pyproject.toml と server.json の両方でバージョンを更新し、一致するタグをプッシュします。

git tag v0.2.0 && git push origin v0.2.0

これにより、テストスイートが実行され、タグが両方のバージョンフィールドと一致することが確認された後、PyPI に公開され、MCP レジストリにも再公開されます。どちらも GitHub OIDC を使用しており、PyPI では Trusted Publishing を使用します。そのため、このリポジトリにも、シークレットストアにも、どのマシンにも API トークンはありません。

概要

Vessark が構築し、保守しています。このリポジトリのツールは無料プランに含まれ、MIT ライセンスのもとでオープンソースとして公開されています。Vessark のワークスペースツール（接続済みのワークスペースで動作するツール）は商用製品であり、オープンソースではありません。

イシューやプルリクエストを歓迎します。