Numeratica MCPサーバー
✓ 検証済み退職後のモンテカルロ・シミュレーション、税金、RMD(強制最低引き出し額)、社会保障など、決定論的な米国財務計画の計算をAIクライアントで実行できます。
別名 numeratica/mcp, mcp, @numeratica/mcp
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.1.5
- 最終コミット
- 2026年7月28日
- ライセンス
- MIT
Numeratica MCPとは
NumeraticaはMCPサーバーです。 退職後のモンテカルロ・シミュレーション、税金、RMD(強制最低引き出し額)、社会保障など、決定論的な米国財務計画の計算をAIクライアントで実行できます。.
プロジェクトのREADMEから生成された概要
Numeratica MCP server について
Numeraticaは、Claude DesktopやCursorなどのAIクライアントが、決定論的な米国の財務計画計算にアクセスするための専用ブリッジを提供します。このMCP serverは、リクエストをホストされたNumeratica APIに転送するトランスポート層として機能し、すべての計算ロジックが中央集権化され、正確であることを保証します。これにより、退職後のモンテカルロ・シミュレーション、税金計算、RMDの評価、社会保障計画、Roth変換などの複雑なタスクを実行できます。
ユーザーは、npxを使用して初期設定なしですぐにサーバーを実行し、discovery-onlyモードで利用可能なツールカタログを閲覧できます。実際の財務計算を実行するには、環境変数を通じてNUMERATICA_API_KEYを提供する必要があります。このサーバーは実行時の依存関係をゼロにするよう設計されており、Nodeの組み込みfetchおよびreadline機能を利用して軽量なフットプリントを維持しています。ローカルのMCPクライアントとリモートのAPIエンドポイントを繋ぐ、軽量なワイヤーとして機能します。
できること
- 1退職シナリオのシミュレーション特定の退職年齢と現在の年齢に基づいたモンテカルロ・シミュレーションをAIに依頼します。
- 2利用可能な財務ツールの探索discovery-onlyモードを使用すると、APIキーなしで利用可能な76種類のツール全リストを確認できます。
- 3複雑な納税義務の計算AIインターフェースを通じて、税金、RMD、社会保障を含む特定の財務計画計算をリクエストします。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Numeratica MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにNumeratica MCPをインストール
$ claude mcp add --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp -- npx -y @numeratica/mcpCursorにNumeratica MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}VS CodeにNumeratica MCPをインストール
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}VS Code CLIにNumeratica MCPをインストール
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@numeratica/mcp"],"env":{"NUMERATICA_API_KEY":"<YOUR_NUMERATICA_API_KEY>"}}'Claude DesktopにNumeratica MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}CodexにNumeratica MCPをインストール
$ codex mcp add mcp --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' -- npx -y @numeratica/mcpCodex config.tomlにNumeratica MCPをインストール
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@numeratica/mcp"] [mcp_servers.mcp.env] NUMERATICA_API_KEY = "<YOUR_NUMERATICA_API_KEY>"
Gemini CLIにNumeratica MCPをインストール
$ gemini mcp add -s user -e 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp npx -- -y @numeratica/mcpGemini settings.jsonにNumeratica MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@numeratica/mcp"
],
"env": {
"NUMERATICA_API_KEY": "<YOUR_NUMERATICA_API_KEY>"
}
}
}
}設定
NUMERATICA_API_KEY必須シークレットNumeratica API key (nmr_sk_...). Free self-serve key at https://docs.numeratica.com/get-key
NUMERATICA_BASE_URLOverride the API base URL. Defaults to https://api.numeratica.com; only needed for a staging or self-hosted deployment.
NUMERATICA_TIMEOUT_MSPer-request timeout in milliseconds (default 120000, minimum 1000). Raise it for long-horizon Monte Carlo runs.
| 名前 | 説明 | 種類 |
|---|---|---|
| NUMERATICA_API_KEY | Numeratica API key (nmr_sk_...). Free self-serve key at https://docs.numeratica.com/get-key | 必須シークレット |
| NUMERATICA_BASE_URL | Override the API base URL. Defaults to https://api.numeratica.com; only needed for a staging or self-hosted deployment. | |
| NUMERATICA_TIMEOUT_MS | Per-request timeout in milliseconds (default 120000, minimum 1000). Raise it for long-horizon Monte Carlo runs. |
自動チェック
実行日 2026年11月15日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能numeratica/mcp is public and reachablegithub.com/numeratica/mcp ↗合格
- パッケージがこのリポジトリをソースとして指定@numeratica/mcp names numeratica/mcp as sourcenpmjs.com/package/@numeratica/mcp ↗合格
- ビルドの来歴 (Sigstore 証明)Sigstore attestation for @numeratica/mcpnpmjs.com/package/@numeratica/mcp/v/0.1.5#provenance ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-07-28github.com/numeratica/mcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from @numeratica/mcp合格
- パッケージおよびその依存関係に重大な勧告なし1 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答initialize answered with protocol 2025-06-18 in 100 ms合格
README
GitHubで見る@numeratica/mcp
A thin MCP bridge that connects any MCP client (Claude Desktop, Cursor, …) to the Numeratica financial-planning API — retirement Monte Carlo, taxes, RMDs, Social Security, Roth conversions, and more.
Get a free key at https://docs.numeratica.com.
How it works
This package is a transport bridge, nothing more. It reads JSON-RPC from stdin and forwards each message to the hosted POST /mcp endpoint with your API key as a bearer token, then writes the response back to stdout. The tool list and all results come straight from the API — so the bridge always stays in sync and ships no calculation logic of its own. Your key is sent only in the Authorization header and is never logged.
- Zero runtime dependencies (Node ≥ 20 built-in
fetch+node:readline). - Open source (MIT). The interesting part is the API; this is just the wire.
Install
No install needed — your MCP client runs it on demand with npx. (You can also npm i -g @numeratica/mcp to get the numeratica-mcp command.)
Step 1 — look around, no key needed
Start here. This config needs no signup and no key:
{
"mcpServers": {
"numeratica": {
"command": "npx",
"args": ["-y", "@numeratica/mcp"]
}
}
}
Put it in claude_desktop_config.json (Claude Desktop: Settings → Developer → Edit
Config) or ~/.cursor/mcp.json (Cursor, or a project .cursor/mcp.json), then
restart the client. All 76 tools appear, and you can ask what's available — "What
Numeratica tools do you have?"
Without a key the bridge runs in discovery-only mode: browsing the catalogue works, running a calculation returns a message telling you to add a key. That's the intended state, not a failure.
Step 2 — add a key to run calculations
Get a free key at docs.numeratica.com/get-key, then add one line:
{
"mcpServers": {
"numeratica": {
"command": "npx",
"args": ["-y", "@numeratica/mcp"],
"env": { "NUMERATICA_API_KEY": "nmr_sk_your_key_here" }
}
}
}
Restart, and the tools are live. Try: "Run a retirement Monte Carlo for a 40-year-old retiring at 65."
Configuration
| Variable | Required | Default | Notes |
|---|---|---|---|
NUMERATICA_API_KEY |
to run calculations | — | Your key. Get one free at docs.numeratica.com/get-key. Never logged. Omit it to browse the catalogue in discovery-only mode. |
NUMERATICA_BASE_URL |
no | https://api.numeratica.com |
Override the API base (e.g. for testing). |
You can also pass the key with --key <value> or --key=<value> instead of the env
var, but prefer NUMERATICA_API_KEY: a key on the command line is visible to
ps for every user on the machine, lands in shell history, and is stored verbatim
in MCP client config files that people routinely paste into issue reports. For a
non-env option that avoids all three, use --key-file <path>.
Links
- API docs & reference: https://docs.numeratica.com
- Get a free key: https://docs.numeratica.com/get-key
License
MIT © Numeratica / Francis Townsend-Merino
Numeratica MCPのよくある質問
Numeratica MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'NUMERATICA_API_KEY=<YOUR_NUMERATICA_API_KEY>' mcp -- npx -y @numeratica/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Numeratica MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
APIキーの安全性は確保されていますか?
はい、キーはAuthorizationヘッダーでのみ送信され、ブリッジによってログに記録されることはありません。