EveryCalc

EveryCalc

あらゆるライフステージに役立つ無料の金融計算ツールを、REST APIとMCP サーバーとして公開し、AI アシスタントが代わりに計算できるようにします。

ライブサイト： https://everycalc.xyz API ドキュメント（OpenAPI）： https://everycalc.xyz/api/v1/openapi.json MCP エンドポイント： POST https://everycalc.xyz/mcp（ストリーミング可能な HTTP、認証不要）

概要

EveryCalc は、個人の財務に関するインタラクティブな計算ツールを集めたものです。このリポジトリには、これらの計算ツールを利用する、機械連携向けインターフェースのサーバーコードが含まれています。

1. REST API（everycalc.xyz/api/v1/*）— GET エンドポイントで、JSON の入力と出力に対応します。
2. MCP サーバー（POST everycalc.xyz/mcp）— Model Context Protocol クライアント（Claude、Cursor など）向けの8つの計算ツールです。

API キーは不要です。登録も不要です。ホスト版を利用する場合、ローカルへのインストールも不要です。

すべてのツールの結果には、everycalc.xyz の対応するインタラクティブな計算ツールへのディープリンク calculator_url が含まれているため、アシスタントが計算した後に、ユーザーは数値を視覚的に確認できます。

8つのツール

ツール	計算内容
calculate_mortgage	毎月の支払い内訳：元利償還方式による元金と利息に加え、固定資産税、住宅保険、PMI、HOA
calculate_refinance	借り換えの損益分岐月と生涯にわたる節約額
calculate_affordability	28/36ルールによる住宅購入可能額
calculate_loan	元利均等返済ローンの支払い
calculate_compound_interest	毎月の積み立てを考慮した複利の予測
calculate_percentage	パーセンテージの計算
calculate_tip	チップと請求額の割り勘
calculate_salary	時給、週給、隔週給、月給、年俸間の給与換算

ホスト型 MCP サーバーを利用する

以下を MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "everycalc": {
      "url": "https://everycalc.xyz/mcp"
    }
  }
}

設定はこれだけです。サーバーはリモート（ストリーミング可能な HTTP）なので、インストールは不要です。

REST API を利用する

すべてのエンドポイントは、クエリパラメーターを使用する GET です。例：

GET https://everycalc.xyz/api/v1/calculate/mortgage?home_price=400000&down_payment_pct=20&annual_rate_pct=6.5&term_years=30

レスポンス：

{
  "ok": true,
  "tool": "calculate_mortgage",
  "inputs": { "homePrice": 400000, "annualRatePct": 6.5, "termYears": 30, "...": "..." },
  "results": {
    "loan_amount": 320000,
    "down_payment_usd": 80000,
    "monthly_principal_interest": 2022.62,
    "monthly_total": 2022.62,
    "total_interest": 408142.36,
    "total_cost": 808142.36
  },
  "calculator_url": "https://everycalc.xyz/mortgage-calculator/"
}

利用可能なエンドポイント（仕様の全文は openapi.json を参照）：

• GET /api/v1/health
• GET /api/v1/calculate/mortgage
• GET /api/v1/calculate/refinance
• GET /api/v1/calculate/affordability
• GET /api/v1/calculate/loan
• GET /api/v1/calculate/compound-interest
• GET /api/v1/calculate/percentage
• GET /api/v1/calculate/tip
• GET /api/v1/calculate/salary
• GET /api/v1/openapi.json

エラー時は、適切な HTTP ステータスとともに {"ok": false, "error": {"code": "...", "message": "...", "field": "..."}} を返します。

自分で実行する

このサーバーは Cloudflare Worker です。計算ロジックは src/engine.js に純粋関数（I/O なし）として実装されており、REST ハンドラーと src/index.js の MCP ハンドラーで共有されています。

前提条件：Node 18 以降、wrangler。

npm install -g wrangler
wrangler login
# point [assets] directory at your static-site build, then:
wrangler deploy

OpenAPI ドキュメントは同じハンドラーから生成されるため、API ドキュメントが実際の動作と食い違うことはありません。

テスト

npm test

test/test.mjs は純粋な計算関数に対して REST エンドポイントをテストし、test/test-mcp.mjs は MCP ツールハンドラーをテストします。直近のデプロイ時点では、すべてのテストが成功しています。

MCP レジストリ

このリポジトリには、公式 MCP レジストリ向けのマニフェスト server.json が含まれています。

ライセンス

MIT。詳細は LICENSE を参照してください。