plainyogurt21-sec-edgar-mcp

https://github.com/user-attachments/assets/d310eb42-b3ca-467d-92f7-7d132e6274fe

重要

EDGAR® および SEC® は、米国証券取引委員会の商標です。このオープンソースプロジェクトは、米国証券取引委員会とは提携しておらず、同委員会による承認も受けていません。

はじめに 📣

SEC EDGAR MCP は、AI モデルをSEC EDGAR の提出書類の豊富なデータセットに接続するオープンソースの MCP サーバーです。EDGAR（Electronic Data Gathering, Analysis, and Retrieval）は、企業が公式な提出書類を提出するために米国 SEC が運用する主要なシステムです。数百万件の提出書類を収録し、企業の財務情報を無料で一般公開することで、「証券市場の効率性、透明性、公平性を高めています」。このプロジェクトにより、金融調査、投資に関する知見、企業の透明性に関するユースケースで、企業データの宝庫を AI アシスタント（LLM）から利用できます。

Model Context Protocol（MCP）を使用しています。これは、「LLM アプリケーションと外部データソースおよびツールとのシームレスな統合を可能にする」オープン標準です。SEC EDGAR MCP サーバーは、SEC 提出書類データにアクセスするための包括的なツール群を提供します。内部では、EdgarTools Python ライブラリを活用して SEC の公式ソースからデータを取得し、正確な財務情報を得るために XBRL を直接解析します。これにより、AI エージェントが「Apple の最新の 10-K 提出書類は何ですか？」や「Tesla の最新の 10-K から正確な売上高を表示してください」と質問すると、MCP サーバーは EDGAR の公式データから、提出書類への参照とともに正確な回答を取得できます。

ヒント

このソフトウェアを使用する場合は、CITATION.cffに従って引用するか、次の APA 形式の文献情報を記載してください。

Amorelli, Stefano (2025). SEC EDGAR MCP (Model Context Protocol) Server [Computer software]. GitHub. https://github.com/stefanoamorelli/sec-edgar-mcp

使用方法 🚀

SEC EDGAR MCP サーバーを起動したら、MCP 対応クライアント（AI アシスタントや MCP CLI ツールなど）を使って接続できます。クライアントは利用可能な EDGAR ツールを検出し、それらを呼び出して SEC 提出書類からリアルタイムのデータを取得できます。たとえば、AI アシスタントはこのサーバーを使って、企業の最近の提出書類を取得したり、手作業でウェブ検索することなく特定の財務指標を照会したりできます。

詳細なガイド、例、ツールのドキュメントについては、SEC EDGAR MCP ドキュメントをご覧ください。

デモ：AI アシスタントが SEC EDGAR MCP を使って Apple の最新の提出書類と財務情報を取得する様子をご紹介します（クリックすると動画を視聴できます）。

上のデモでは、アシスタントが SEC EDGAR MCP のツールを使って Apple の提出書類と財務データを取得しています。EDGAR の情報が、正確な精度と提出書類への参照情報とともにリアルタイムで取得・提示される様子をご覧いただけます。📊

ドキュメント 📚

インストールとセットアップの手順については、SEC EDGAR MCP クイックスタートガイドをご覧ください。ツールの全ドキュメント、使用例、設定ガイドについては、SEC EDGAR MCP ドキュメントをご覧ください。

アーキテクチャ 🏗️

SEC EDGAR MCP サーバーは、AI（MCP クライアント）と SEC の EDGAR バックエンドの間を仲介します。

• 🔸 MCP クライアント：AI アシスタント（Claudeなど）やその他の MCP 対応ツール、または MCP プロトコルで通信する任意のアプリを指します。クライアントはツールを呼び出すための JSON-RPC リクエストを送信し、JSON の結果を受け取ります。

• 🔸 MCP サーバー（SEC EDGAR MCP）：このサーバーは包括的な EDGAR ツールを提供し、受信したリクエストを処理します。次の機能を備えています。

  • 企業ツール：CIK の検索、企業情報、企業のファクト
  • 提出書類ツール：最近の提出書類、提出書類の内容、8-K 分析、セクションの抽出
  • 財務ツール：正確な精度を実現する、XBRL の直接解析による財務諸表
  • インサイダー取引ツール：詳細な取引データを用いた Form 3/4/5 の分析

• 🔸 EDGAR データソース：サーバーはedgartools Python ライブラリを使って、次の情報にアクセスします。

  • SEC EDGAR REST API：企業データと提出書類のメタデータを提供する、SEC の公式エンドポイント
  • XBRL の直接解析：正確な数値精度を実現するため、正規表現パターンを使って SEC 提出書類から財務データを直接抽出します
  • 提出書類の内容：SEC 提出書類の完全な文書（.txt 形式）をダウンロードして解析します

主な機能：

• 決定論的な応答：すべてのツールに、AI の幻覚を防ぎ、SEC 提出書類のデータのみに基づいた応答を確実にするための厳格な指示が含まれています
• 正確な精度：財務データは、SEC への提出時と同じ正確な数値精度を維持します（丸め処理はありません）
• 提出書類の参照情報：すべての応答に、独立した検証に使用できるクリック可能な SEC の URL が含まれます
• 柔軟な XBRL 抽出：ハードコードされたマッピングを使わずに、パターンマッチングで財務上の概念を見つけます

仕組み：MCP クライアントは、利用可能なツール（企業検索、財務諸表、インサイダー取引など）を検出します。呼び出されると、各ツールは SEC のデータソースからデータを取得し、決定論的な処理ルールを適用して、提出書類の参照情報を含む構造化された JSON を返します。これにより、AI の応答は正確で検証可能となり、公式な SEC データのみに基づいたものになります。

参考資料 📚

• SEC EDGAR – EDGAR について、SEC.gov（2024 年）。EDGAR は、企業の電子提出書類を管理する SEC のデータベースです。

• Model Context Protocol (MCP) – 公式ドキュメントと SDK。ModelContextProtocol.io – LLM をツールに接続するためのオープン標準です。

• EdgarTools – SEC EDGAR データにアクセスするための、強力な提出書類分析機能を備えたモダンな Python ライブラリです。GitHub リポジトリ、ドキュメント。

ライセンス ⚖️

このプロジェクトは MIT License のもとでライセンスされています。自由に使用、変更、再配布できます。詳細は LICENSE ファイルをご覧ください。

---

© 2025 Stefano Amorelli – MIT license のもとで公開されています。お楽しみください！🎉