Secfinapi

secfinapi-mcp

SECfinAPI 用 MCP サーバーです。SEC EDGAR の標準化された財務データ（損益計算書、貸借対照表、キャッシュフロー、40 以上の財務指標）を、Claude、Cursor、その他の AI アシスタントで使えるツールとして提供します。

AI アシスタントに 「Apple の売上高の推移は？」 や 「MSFT と GOOGL の営業利益率を比較して」 などと尋ねると、SECfinAPI を通じてリアルタイムにデータを取得します。

お使いのマシン上でローカルに動作し、SECfinAPI REST API を薄くラップしています。ホストするサーバーは不要で、追加料金もかかりません。

セットアップ

1. https://www.secfinapi.com で API キー（無料）を取得します。
2. お使いの AI アシスタントの MCP 設定にサーバーを追加します。

Claude Desktop

Settings → Developer → Edit Config を開き、次を追加します。

npm で公開後：

{
  "mcpServers": {
    "secfinapi": {
      "command": "npx",
      "args": ["-y", "secfinapi-mcp"],
      "env": { "SECFINAPI_KEY": "your-api-key-here" }
    }
  }
}

公開前にソースから実行する場合：

{
  "mcpServers": {
    "secfinapi": {
      "command": "node",
      "args": ["C:/path/to/sec-financial-mcp/dist/index.js"],
      "env": { "SECFINAPI_KEY": "your-api-key-here" }
    }
  }
}

Claude Desktop を再起動します。以下の 6 つのツールが、ツール（🔌）メニューに表示されます。

Cursor / VS Code

エディターの MCP 設定で、同じ形式の設定を使用します。command、args、および SECFINAPI_KEY 環境変数を指定します。

ツール

ツール	戻り値
get_company_info	企業のメタデータと、SEC EDGAR の提出書類へのリンク
get_income_statement	標準化された損益計算書（提出日付き）
get_balance_sheet	標準化された貸借対照表
get_cash_flow	標準化されたキャッシュフロー計算書
get_metrics	40 以上の財務指標（ROE、ROIC、利益率、成長率など）
list_companies	利用可能な米国上場企業の一覧表示／検索

環境変数

変数	必須	デフォルト
SECFINAPI_KEY	はい	—
SECFINAPI_BASE_URL	いいえ	SECfinAPI の本番 API

ソースから実行

npm install
npm run build
SECFINAPI_KEY=your-key node dist/index.js

公開（メンテナー向け）

npm run build
npm publish

ライセンス

MIT