Sec Edgar MCP

🚀 SEC EDGAR MCP 項目文檔

SEC EDGAR MCP 項目提供了一個接口，讓 AI 模型能夠藉助 Model Context Protocol (MCP) 訪問美國證券交易委員會（SEC）的 EDGAR 數據庫。EDGAR 是 SEC 的電子化公司文件提交系統，涵蓋了上市公司的監管文件，像 10 - K、8 - K 等重要財務報告。通過 MCP 協議，AI 模型可調用一系列工具來查詢和分析 SEC 的公開數據，實現對上市公司財務狀況、治理結構等信息的自動化獲取與處理。

🚀 快速開始

SEC EDGAR MCP 項目為 AI 模型訪問 SEC 的 EDGAR 數據庫搭建了橋樑，藉助 MCP 協議，可利用多種工具對公開數據進行查詢和分析。

✨ 主要特性

• 提供標準化接口，使 AI 模型能通過 MCP 協議訪問 SEC 的 EDGAR 數據庫。
• 集成多種工具，可對上市公司的監管文件進行查詢和分析。
• 實現對上市公司財務狀況、治理結構等信息的自動化獲取和處理。

📦 安裝指南

文檔未提及安裝步驟，此部分跳過。

💻 使用示例

基礎用法

1. 獲取提交記錄 (get_submissions)

{
  "jsonrpc": "2.0",
  "method": "get_submissions",
  "params": {
    "cik": "0001369748"
  },
  "id": 1
}

此工具用於檢索指定公司（通過 CIK 或 Ticker）的所有 SEC 提交記錄。參數方面，cik 是公司的 Central Index Key（可選，若未提供，則需提供 ticker）；ticker 是公司的股票代碼（可選，若未提供，則需提供 cik）。返回的是公司提交的所有 filings 的元數據列表，包含 accessionNumber（提交記錄的唯一標識符）、formType（提交的表格類型，如 10 - K, 8 - K 等）、actionDate（提交日期）、filedAt（文件的實際提交時間）、description（表格的簡要描述）等字段。

2. 獲取 filings 內容 (get_filing)

{
  "jsonrpc": "2.0",
  "method": "get_filing",
  "params": {
    "accessionNumber": "0001369748-23-00001"
  },
  "id": 1
}

該工具用於返回指定提交記錄的完整內容。參數為 accessionNumber（提交記錄的唯一標識符），返回的是提交記錄的 JSON 格式內容，包含 infoTable（基本信息表）、formData（表單數據）、XBRLData（可擴展商業報告語言 (XBRL) 數據，若適用）等字段。

3. 獲取 XBRL 數據 (get_xbrl)

{
  "jsonrpc": "2.0",
  "method": "get_xbrl",
  "params": {
    "accessionNumber": "0001369748-23-00001"
  },
  "id": 1
}

此工具用於返回指定提交記錄中的 XBRL (可擴展商業報告語言) 數據。參數是 accessionNumber（提交記錄的唯一標識符），返回的是 XBRL 格式的財務數據，包含收入、利潤、負債等關鍵指標。

📚 詳細文檔

可用工具 🔧

1. 獲取提交記錄 (get_submissions)

• 功能：檢索指定公司（通過 CIK 或 Ticker）的所有 SEC 提交記錄。
• 參數：
  • cik：公司的 Central Index Key（可選，如果未提供，則需要提供 ticker）
  • ticker：公司的股票代碼（可選，如果未提供，則需要提供 cik）
• 返回：返回公司提交的所有 filings 的元數據列表，包括以下字段：
  • accessionNumber：提交記錄的唯一標識符
  • formType：提交的表格類型（如 10 - K, 8 - K 等）
  • actionDate：提交日期
  • filedAt：文件的實際提交時間
  • description：表格的簡要描述

2. 獲取 filings 內容 (get_filing)

• 功能：返回指定提交記錄的完整內容。
• 參數：
  • accessionNumber：提交記錄的唯一標識符
• 返回：返回提交記錄的 JSON 格式內容，包括以下字段：
  • infoTable：基本信息表
  • formData：表單數據
  • XBRLData：可擴展商業報告語言 (XBRL) 數據（如果適用）

3. 獲取 XBRL 數據 (get_xbrl)

• 功能：返回指定提交記錄中的 XBRL (可擴展商業報告語言) 數據。
• 參數：
  • accessionNumber：提交記錄的唯一標識符
• 返回：返回 XBRL 格式的財務數據，包括收入、利潤、負債等關鍵指標。

注意事項 🛠️

• 所有工具的調用都需要提供有效的 CIK 或 Ticker。
• 調用前請仔細閱讀 SEC 的 官方文檔 和 MCP 協議的要求。
• 由於 SEC 數據庫的限制，部分歷史數據可能無法訪問。

架構 🗖️

項目的架構如下：

1. MCP 客戶端：負責接收和處理來自 AI 模型的請求，並將其轉發到服務器。
2. MCP 服務器：負責解析請求、調用相應的 EDGAR API，並將結果返回給客戶端。
3. EDGAR REST API：SEC 提供的公共接口，用於查詢和獲取 filings 數據。

整個流程如下：

AI 模型 -> MCP 客戶端 -> MCP 服務器 -> EDGAR REST API -> 返回結果

參考資料 📚

1. SEC 官網 (官網，2024)
2. MCP 協議文檔
3. EDGAR API 文檔

🔧 技術細節

文檔未提供具體技術實現細節，此部分跳過。

📄 許可證

本項目在 MIT 許可證下開源，允許用戶自由使用、修改和分發。完整許可內容請參考 LICENSE 文件。