Asian Financial Filings MCP Server

非官方亚洲金融文件MCP服务器

一种模型上下文协议（MCP）服务器，通过日本的EDINET和韩国的DART系统提供对亚洲财务文件的全面访问。该服务器使人工智能助手和应用程序能够搜索、检索和分析来自7700多家亚洲公司的财务报表和XBRL数据。

主要特点

• 日本覆盖范围：通过EDINET（投资者网络电子披露）访问5000多家公司
• 韩国覆盖范围：通过DART（数据分析、检索和传输系统）访问2700多家公司
• 完成归档访问：检索归档历史和文件详细信息
• XBRL解析：完整的iXBRL/XBRL-JSON解析，支持J-GAAP和K-GAAP分类法
• 量纲分析：从财务数据中提取细分市场、地理和产品细分
• 时间序列分析：多期增长率、趋势和组合分析（第2阶段）
• 事实数据表：构建具有价值搜索和偏差分析的BI就绪事实表（第2阶段）
• 综合数据：公司信息、财务报表、股东、高管、股息
• MCP兼容：与Cursor、Claude Desktop和其他MCP客户端无缝协作
• 免费API：EDINET和DART都提供免费访问（需要API密钥）

什么是EDINET和DART？

EDINET（日本）

投资者网络电子披露是日本金融厅（FSA）运营的强制性电子报告系统。自2008年以来，所有上市公司和主要筹资实体都必须使用符合J-GAAP（日本公认会计准则）分类标准的XBRL格式的EDINET提交披露文件。

数据源: 埃迪内 -API密钥注册的免费公共访问

DART（韩国）

数据分析、检索和传输系统是韩国金融监管局（FSS）运营的电子披露存储库。KOSPI、KOSDAQ和KONEX交易所的公司使用K-GAAP/IFRS标准通过DART提交报告。

数据源: 打开DART -带密钥注册的免费公共API

安装和设置

先决条件

您将需要来自两个服务的API密钥（免费注册）：

1. EDINET API密钥:

- 访问：https://disclosure.edinet-fsa.go.jp/ - 使用电子邮件注册 - 完成多因素身份验证 - 接收您的订阅密钥

1. DART API密钥:

- 访问：https://opendart.fss.or.kr/intro/main.do - 注册API免费访问 - 接收您的API密钥 - 速率限制：1000个请求/分钟

用法

{
  "mcpServers": {
    "asia-filings": {
      "command": "node",
      "args": ["/path/to/asia-filings-mcp-server/build/index.js"],
      "env": {
        "EDINET_API_KEY": "your-edinet-api-key-here",
        "DART_API_KEY": "your-dart-api-key-here"
      }
    }
  }
}

完整的API参考资料

服务器提供统一的 asia-filings 工具与 19种强大的方法 （包括第二阶段高级分析）：

日本EDINET方法

1.搜索公司(search_japan_companies)

按名称查找日本公司（日语或英语）。

{
  "method": "search_japan_companies",
  "query": "Toyota",
  "limit": 10
}

退货：具有EDINET代码和最近备案信息的匹配公司列表。

2.通过EDINET代码获取公司(get_japan_company_by_code)

使用EDINET代码查找特定公司。

{
  "method": "get_japan_company_by_code",
  "edinet_code": "E01225"
}

退货：公司详细信息，包括名称、代码和最新备案。

3.获取公司文件(get_japan_company_filings)

检索一家日本公司的备案历史。

{
  "method": "get_japan_company_filings",
  "edinet_code": "E01225",
  "start_date": "2023-01-01",
  "end_date": "2024-12-31",
  "limit": 100
}

退货：包含文档和查看器URL的文件数组。

4.获取归档文件(get_japan_filing_document)

下载特定的归档文件。

{
  "method": "get_japan_filing_document",
  "document_id": "S100XXXX",
  "document_type": "4"
}

文档类型：1=提交，2=PDF，3=附件，4=XBRL

5.按日期获取文件(get_japan_documents_by_date)

获取在特定日期提交的所有文件。

{
  "method": "get_japan_documents_by_date",
  "date": "2024-12-01"
}

6.获取归档事实-XBRL解析器(get_japan_filing_facts)

从日本文件中提取并解析XBRL事实。使用J-GAAP分类法解析内联XBRL（iXBRL）。

{
  "method": "get_japan_filing_facts",
  "document_id": "S100XXXX"
}

退货：分析的XBRL事实包括：

• 带有值、单位和小数的数字事实
• 上下文信息（时段、实体）
• 维度数据（分段、地理）
• 按事实类型汇总统计
• 分类学分类

7.获取维度事实(get_japan_dimensional_facts)

从日本XBRL文件中提取维度细分（例如，按细分市场、地理区域或产品线划分的收入）。

{
  "method": "get_japan_dimensional_facts",
  "document_id": "S100XXXX",
  "search_criteria": {
    "concept": "revenue",
    "hasDimensions": true
  }
}

退货：通过维度分析过滤事实，包括地理、细分和产品细分。

韩国DART方法

8.搜索公司(search_korea_companies)

按名称查找韩国公司。

{
  "method": "search_korea_companies",
  "query": "Samsung",
  "limit": 10
}

退货：具有公司代码和最近提交的文件的匹配公司列表。

9.通过公司代码获得公司(get_korea_company_by_code)

使用公司代码查找特定公司。

{
  "method": "get_korea_company_by_code",
  "corp_code": "00126380"
}

退货：全面的公司简介，包括首席执行官、地址和业务详细信息。

10.获取公司文件(get_korea_company_filings)

检索韩国公司的备案历史。

{
  "method": "get_korea_company_filings",
  "corp_code": "00126380",
  "start_date": "2023-01-01",
  "end_date": "2024-12-31",
  "report_type": "A",
  "limit": 100
}

报告类型A=年度，Q=季度

11.获取财务报表-XBRL解析器(get_korea_financial_statements)

提取并解析特定时期的XBRL财务数据。分析K-GAAP/IFRS分类数据。

{
  "method": "get_korea_financial_statements",
  "corp_code": "00126380",
  "business_year": "2023",
  "report_code": "11011"
}

报告代码：11011=年度，11013=第一季度，11012=第二季度，11014=第三季度

退货：分析的XBRL财务事实包括：

• 具有K-GAAP概念的账户名称和ID
• 当前项、上一项和上一项之前的值
• 按账户类型汇总统计
• 分类学分类（资产、负债、权益、收入、支出）

12.获取维度事实(get_korea_dimensional_facts)

从韩国XBRL财务报表中提取维度细分（例如，按业务部门或地理区域划分的收入）。

{
  "method": "get_korea_dimensional_facts",
  "corp_code": "00126380",
  "business_year": "2023",
  "report_code": "11011",
  "search_criteria": {
    "concept": "매출",
    "hasValue": true
  }
}

退货：按地理位置、细分市场和产品进行维度分析，过滤财务事实。

13.获得主要股东(get_korea_major_shareholders)

检索大股东信息。

{
  "method": "get_korea_major_shareholders",
  "corp_code": "00126380"
}

退货：股东姓名、持股比例和变更原因。

14.获取高管信息(get_korea_executive_info)

获取有关公司高管和高级职员的信息。

{
  "method": "get_korea_executive_info",
  "corp_code": "00126380"
}

退货：高管姓名、职位、出生年份和职业。

15.获取股息信息(get_korea_dividend_info)

检索股息分配信息。

{
  "method": "get_korea_dividend_info",
  "corp_code": "00126380",
  "business_year": "2023"
}

退货：指定营业年度的股息分配详情。

实用方法

16.过滤文件(filter_filings)

按日期、报告类型和其他条件筛选归档数组。

{
  "method": "filter_filings",
  "filings": [...],
  "filters": {
    "startDate": "2024-01-01",
    "endDate": "2024-12-31",
    "reportType": "Annual"
  }
}

退货：已过滤的带计数的归档数组。

高级分析方法（第2阶段）

17.构建事实表(build_fact_table)

使用商业智能摘要围绕目标值构建全面的事实表。在容差范围内搜索XBRL事实，并提供维度细分。

{
  "method": "build_fact_table",
  "country": "JP",
  "company_id": "E01225",
  "target_value": 1000000000000,
  "tolerance": 50000000000,
  "document_id": "S100XXXX",
  "options": {
    "maxRows": 25,
    "showDimensions": true,
    "sortBy": "deviation"
  }
}

参数：

• country：“JP”（日本）或“KR”（韩国）
• company_id：EDINET代码（JP）或公司代码（KR）
• target_value：要搜索的目标值（日元或韩元）
• tolerance：搜索范围公差（±）
• document_id：可选文档ID（JP）或“业务年度：报告代码”格式（KR）
• options：表配置（maxRows、sortBy、过滤器）

退货：综合事实表，包括：

• 按与目标的偏差排序的价值范围内的事实
• 商业智能摘要
• 地理和细分市场
• 偏差分析和精确匹配
• 价值统计和业务分类

18.按价值搜索事实(search_facts_by_value)

别名为 build_fact_table -在值范围内搜索XBRL事实。与build_fact_table具有相同的参数和功能。

19.时间序列分析(time_series_analysis)

分析多个时期的财务指标，包括期间增长率、地理/细分市场组合变化和趋势检测。

{
  "method": "time_series_analysis",
  "country": "KR",
  "company_id": "00126380",
  "options": {
    "concept": "Revenue",
    "periods": 4,
    "includeGeography": true,
    "includeSegments": true,
    "showGrowthRates": true
  }
}

参数：

• country：“JP”（日本）或“KR”（韩国）
• company_id：EDINET代码（JP）或公司代码（KR）
• options：分析配置

- concept：要跟踪的财务概念（例如“收入”、“资产”、“净收入”） - periods：要分析的时段数（默认值：4） - includeGeography：包括地域细分 - includeSegments：包括细分市场 - showGrowthRates：计算各时期的增长率

退货：时间序列分析，包括：

• 跨时间事实的多期数据表
• 按地理区域/细分市场划分的环比增长率
• 地理混合分析（成分随时间变化）
• 部门组合分析（业务部门演变）
• 趋势检测（增加、减少、稳定）
• 增长率汇总和平均值

覆盖

日本（EDINET）

• 公司：约5000家上市公司+3000只投资基金
• 交换：东京证券交易所（TSE）
• 市场划分：优质、标准、增长
• 分类学：J-GAAP（日本公认会计原则）
• 文档类型：65种类型，包括年度报告、季度报告、证券报告
• 历史数据：从2008+（XBRL授权开始）

韩国（DART）

• 公司：约2700家上市公司
• 交易所:

- KOSPI：约880家公司 - KOSDAQ：约1700家公司 - KONEX：约129家公司

• 分类学：韩国公认会计准则/国际财务报告准则
• 披露类型：年度、季度、重大问题、股权、发行、杂项
• 附加数据：股东信息、高管详细信息、股息

真实世界用例

投资研究

{
  "method": "search_japan_companies",
  "query": "Sony",
  "limit": 5
}

*查找日本科技公司并分析其财务报表*

跨市场分析

{
  "method": "search_korea_companies",
  "query": "삼성전자",
  "limit": 10
}

*比较韩国电子公司的财务业绩*

财务数据提取

{
  "method": "get_korea_financial_statements",
  "corp_code": "00126380",
  "business_year": "2023",
  "report_code": "11011"
}

*提取结构化XBRL财务数据进行分析*

股东分析

{
  "method": "get_korea_major_shareholders",
  "corp_code": "00126380"
}

*跟踪主要股东的立场和所有权变动*

XBRL解析与分析

{
  "method": "get_japan_filing_facts",
  "document_id": "S100XXXX"
}

*从日本文件中解析内联XBRL以提取结构化财务数据*

{
  "method": "get_korea_dimensional_facts",
  "corp_code": "00126380",
  "business_year": "2023",
  "report_code": "11011",
  "search_criteria": {
    "concept": "revenue",
    "hasDimensions": true
  }
}

*提取按业务部门或地理位置显示收入的维度细分*

XBRL解析器功能

该服务器包括对日本和韩国文件的全面XBRL解析：

日本（EDINET）-iXBRL解析器

• 格式：嵌入HTML的内联XBRL（iXBRL）
• 分类学：J-GAAP（日本公认会计原则）
• 解析：从以下内容中提取事实 ix:nonFraction 和 ix:nonNumeric 标签
• 上下文：全周期、实体和维度上下文提取
• 清除氧化皮：自动比例因子应用（百万，十亿）
• 数字格式：日文负数符号（△、▲、－）

韩国（DART）-XBRL-JSON解析器

• 格式：API中JSON格式的XBRL数据
• 分类学：韩国公认会计准则/国际财务报告准则
• 解析：帐户名称、ID和多时段值
• 时期：本学期、上学期、前学期
• 韩国支持：Native Korean account names（销售额、资产、负债、资本等）

公共特性

• 事实分类：自动分类（资产、负债、权益、收入、支出、现金流）
• 尺寸提取：地理位置、业务部门、产品线
• 值过滤：按概念、值范围、期间、维度搜索
• 概要统计：按类型、命名空间和维度聚合数据
• UTF-8支持: Full Japanese (汉字，平假名，片假名）and Korean (한글) character support

分类学参考

日本-J-GAAP（日本公认会计准则）

日本公司遵循与美国公认会计准则和国际财务报告准则不同的J-GAAP分类法。EDINET分类法旨在符合《全球归档手册》（GFM）规则。

未来发展：日本计划在2027年之前采用ISSB分类法，并进行日本特有的扩展。

韩国-K-GAAP/IFRS

韩国公司根据其规模和上市状态使用K-GAAP（韩国公认会计准则）或IFRS。财务报表可通过DART API以XBRL格式提供。

建筑

asia-filings-mcp-server/
├── src/
│   ├── index.js              # MCP server implementation
│   ├── edinet-api.js         # Japan EDINET API client
│   ├── dart-api.js           # Korea DART API client
│   ├── xbrl-parser.js        # XBRL/iXBRL parser (J-GAAP, K-GAAP)
│   ├── fact-table-builder.js # Fact table generation & BI summaries
│   └── time-series-analyzer.js # Multi-period growth & trend analysis
├── package.json
└── README.md

与SEC/EU服务器的比较