Synergic-APIs

Synergic APIs — MCP サーバー

Synergic APIs の公式 Model Context Protocol サーバーです。AI エージェントが米国の公式経済データにアクセスできます。Claude、Cursor、および MCP 対応のあらゆるクライアントから、次のデータを直接利用できます。

• 米国インフレーション API — 米国労働統計局が公表する公式 CPI-U：11 カテゴリー、BLS と同じ方法で算出した前年比／前月比、1913 年までさかのぼる月次履歴、公式の年平均。
• 有名商品の価格 — 卵、ガソリン、牛乳、パン、牛ひき肉、コーヒー、電気の米国平均価格。1976 年以降の月次データです。
• 米国国債 API — 米国財務省が公表する、1 セント単位の米国債務データ。1993 年以降の各営業日データ、1790 年以降の年間債務残高、および財務省が支払う平均金利を提供します。

金額はすべて JSON の数値で、期間は YYYY-MM ／ YYYY-MM-DD 形式です。公式記録に存在しない月は null として返され、決して捏造されません。

要件

• Node.js 18.17 以降（npx を含む）。
• Synergic APIs のキー。synergicapis.com/signup.html から無料で取得できます（クレジットカード不要） — 月 500 件のリクエスト、両方の API、全期間の履歴をご利用いただけます。有料プランについては synergicapis.com/pricing.html をご覧ください。

インストール

サーバーは npx 経由で stdio 上で実行されます。リポジトリのクローンやビルドは不要です。

Claude Desktop

claude_desktop_config.json に追加します（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "synergic-apis": {
      "command": "npx",
      "args": ["-y", "@synergic-apis/mcp"],
      "env": {
        "SYNERGIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add synergic-apis --env SYNERGIC_API_KEY=YOUR_API_KEY -- npx -y @synergic-apis/mcp

Cursor

~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "synergic-apis": {
      "command": "npx",
      "args": ["-y", "@synergic-apis/mcp"],
      "env": {
        "SYNERGIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

設定

変数	必須	デフォルト	説明
SYNERGIC_API_KEY	はい	—	API キーです。各リクエストで X-Api-Key として送信されます。
SYNERGIC_GATEWAY_URL	いいえ	https://api.synergicapis.com	ゲートウェイのベース URL（テスト用に上書きできます）。

ツール

ツール	機能	主な引数
get_us_inflation_latest	11 カテゴリーすべての最新月の CPI と、前年比／前月比を取得します。	adjusted（任意）
get_us_inflation_history	1 カテゴリーの月次 CPI 履歴（総合指数は 1913 年以降）を取得します。	category、start／end（YYYY-MM）、limit（≤100）、adjusted
get_us_inflation_annual	公式の年間平均 CPI（M13、NSA）を取得します。limit=150 で総合指数の全系列を取得できます。	category、start／end（YYYY）、limit（≤150）
get_famous_prices	有名な米国商品の最新価格一覧、または 1 商品の月次履歴を取得します。	item（任意）、start／end（YYYY-MM）、limit（≤100）
get_us_debt_latest	本日時点の米国国債額を 1 セント単位で取得します。	—
get_us_debt_history	日次債務額（1993 年以降、limit ≤100）、または会計年度末の年間債務額（1790 年以降、limit=250 で全系列）を取得します。	frequency（daily／annual）、start／end（YYYY-MM-DD）、limit
get_us_interest_rates	証券クラスごとの財務省の最新平均金利、または 1 クラスの月次履歴（2001 年以降）を取得します。	security_class（任意）、start／end（YYYY-MM-DD）、limit（≤100）
get_my_usage	ご利用中のキーのプラン、使用済みリクエスト数、月間上限、リセット日を取得します。	—

履歴取得ツールは期間範囲ごとにページネーションします。レスポンスの meta.next_end が null でない場合は、end にその値を指定してツールを再度呼び出すと、より古いデータを取得できます。

試してみる

アシスタントに、次のように質問してみてください。

• 「現在の米国のインフレ率はどのくらいですか？ 総合指数とコア指数を教えてください。」
• 「2020 年以降の卵の価格をグラフにしてください。」
• 「過去 12 か月で米国の国債額はどのくらい増えましたか？」
• 「財務省が今日 T ビルに支払う金利と、2021 年の金利を比較してください。」

トラブルシューティング

• "SYNERGIC_API_KEY is not set" — キーが設定されていない場合、サーバーは起動時に終了します。MCP クライアントの設定のenvブロックにキーを追加し（上記参照）、クライアントを再起動してください。
• "Invalid API key" — ゲートウェイがキーを拒否しました（入力ミスまたは失効）。キーはsk_...の形式です。synergicapis.com/signup.htmlで新しいキーを取得してください。
• "Rate limit exceeded … retry after Xs" — プランの1分あたりの上限（無料プラン：10 req/min）に達しました。時間をおいて再試行してください。
• "Monthly quota exhausted" — 今月のリクエスト上限（無料プラン：500）に達しました。詳細を確認するには、エージェントにget_my_usageを呼び出すよう依頼するか、1日（UTC）まで待つか、synergicapis.com/pricing.htmlでプランをアップグレードしてください。
• クライアントにツールが表示されない — クライアントのMCPログを確認してください。よくある原因は、Nodeのバージョンが古い（18.17以降が必要）こと、またはクライアントが使用するPATHにnpxがないことです。ターミナルでnpx -y @synergic-apis/mcpを実行すると、標準エラー出力にready on stdioと表示された後、入力待ちになります。
• 企業プロキシ／セルフホスト環境でのテスト — SYNERGIC_GATEWAY_URLをゲートウェイに設定してください。サーバーが送信するのは、X-Api-Keyを含むGETリクエストのみです。

開発

npm install
npm run typecheck   # tsc --noEmit (strict)
npm test            # vitest — tool→request mapping + error mapping, fetch mocked
npm run build       # emits dist/ and the synergic-apis-mcp bin

データソースとライセンス

データ：米国労働統計局および米国財務省財政データ（パブリックドメイン。本製品はどちらの機関からも推奨を受けておらず、提携関係もありません）。 コード：MIT。