Numeratica — financial planning calculations

@numeratica/mcp

あらゆる MCP クライアント（Claude Desktop、Cursor、…）を、退職後のモンテカルロシミュレーション、税金、RMD、社会保障、Roth 変換などに対応する財務計画 API Numeratica に接続する、薄い MCP ブリッジです。

https://docs.numeratica.com で無料のキーを取得できます。

仕組み

このパッケージはトランスポートブリッジにすぎません。標準入力から JSON-RPC を読み取り、各メッセージを API キーをベアラートークンとして付けてホストされた POST /mcp エンドポイントに転送し、その後レスポンスを標準出力に書き込みます。ツール一覧とすべての結果は API から直接返されるため、ブリッジは常に API と同期され、独自の計算ロジックは含みません。キーは Authorization ヘッダーでのみ送信され、ログに記録されることはありません。

• 実行時依存関係はゼロ（Node ≥ 20 組み込みの fetch と node:readline）。
• オープンソース（MIT）です。重要なのは API であり、これは単なる通信経路です。

インストール

インストールは不要です。MCP クライアントが必要に応じて npx で実行します。（npm i -g @numeratica/mcp を実行して numeratica-mcp コマンドを取得することもできます。）

ステップ 1 — キー不要で内容を確認する

まずはこちらから始めてください。この設定では登録もキーも不要です。

{
  "mcpServers": {
    "numeratica": {
      "command": "npx",
      "args": ["-y", "@numeratica/mcp"]
    }
  }
}

これを claude_desktop_config.json（Claude Desktop：Settings → Developer → Edit Config）または ~/.cursor/mcp.json（Cursor、またはプロジェクトの .cursor/mcp.json）に追加し、 クライアントを再起動します。76 個のツールがすべて表示され、利用可能な機能について質問できます。たとえば、「Numeratica のツールには何がありますか？」 と尋ねてみてください。

キーがない場合、ブリッジは検出専用モードで動作します。カタログの閲覧はできますが、計算を実行するとキーを追加するよう促すメッセージが返されます。これは意図された状態であり、障害ではありません。

ステップ 2 — 計算を実行するためにキーを追加する

docs.numeratica.com/get-key で無料のキーを取得し、 次の 1 行を追加します。

{
  "mcpServers": {
    "numeratica": {
      "command": "npx",
      "args": ["-y", "@numeratica/mcp"],
      "env": { "NUMERATICA_API_KEY": "nmr_sk_your_key_here" }
    }
  }
}

再起動すると、ツールが利用可能になります。次のように試してみてください。「65 歳で退職する 40 歳の人を対象に、退職後のモンテカルロシミュレーションを実行してください。」

設定

変数	必須	デフォルト	備考
NUMERATICA_API_KEY	計算の実行に必要	—	キーです。docs.numeratica.com/get-key で無料で取得できます。ログには記録されません。省略すると、検出専用モードでカタログを閲覧できます。
NUMERATICA_BASE_URL	いいえ	https://api.numeratica.com	API のベース URL を上書きします（テスト時など）。

環境変数の代わりに --key <value> または --key=<value> でキーを渡すこともできますが、NUMERATICA_API_KEY の使用をおすすめします。コマンドライン上のキーは、マシン上のすべてのユーザーから ps で確認でき、シェル履歴に残り、問題報告に貼り付けられることの多い MCP クライアント設定ファイルにそのまま保存されるためです。この 3 つすべてを避けられる環境変数以外の方法として、--key-file <path> を使用してください。

リンク

• API ドキュメントとリファレンス： https://docs.numeratica.com
• 無料のキーを取得： https://docs.numeratica.com/get-key

ライセンス

MIT © Numeratica / Francis Townsend-Merino