使用说明

OpenDART MCP服务器

金融监督院 DART电子公告系统 Open API MCP（模型上下文协议）作为服务器提供。

Claude、ChatGPT等支持MCP的AI客户端上，韩国上市企业的公示信息、财务报表、股份公示等 83个API可以用自然语言查询。

事前准备

OpenDART请从中获得API验证密钥。

安装和设置

克劳德桌面

claude_desktop_config.json添加到：

{
  "mcpServers": {
    "opendart": {
      "command": "uvx",
      "args": ["opendart-mcp"],
      "env": {
        "OPENDART_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

设置文件位置：macOS ~/Library/Application Support/Claude/claude_desktop_config.json

克劳德代码

claude mcp add opendart -- uvx opendart-mcp

# API 키 설정
export OPENDART_API_KEY="<YOUR_API_KEY>"

光标/风帆

MCP配置文件（.cursor/mcp.json 或 .windsurf/mcp.json）：

{
  "mcpServers": {
    "opendart": {
      "command": "uvx",
      "args": ["opendart-mcp"],
      "env": {
        "OPENDART_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

SSE（远程服务器）

uvx opendart-mcp --transport sse --host 0.0.0.0 --port 8000

码头工人

docker build -t opendart-mcp .
docker run -e OPENDART_API_KEY="<YOUR_API_KEY>" -p 8000:8000 opendart-mcp

交付工具（83个）

公告信息（4个）

工具	说明
`search_disclosure`	公示搜索（按公司代码、日期、公示类型等过滤）
`get_company_info`	查询企业概况
`get_document` 下载公示原文（ZIP）
`get_corp_code`	下载完整的唯一编号列表

定期报告主要信息（28个）

工具	说明
`get_stock_issuance_status`	增资（土豆）现状
`get_dividend_info`	关于分红的事项
`get_treasury_stock_status`	自己的股票取得和处置情况
`get_largest_shareholder`	最大股东情况
`get_largest_shareholder_change`	最大股东变动情况
`get_minority_shareholder`	小额股东情况
`get_executive_status`	高管现状
`get_employee_status`	员工现状
`get_individual_compensation`	个人报酬支付金额（5亿以上）
`get_total_compensation`	董事、监事整体薪酬情况
`get_top5_compensation`	个人报酬支付金额（前5名）
`get_investment_in_others`	其他法人出资情况
`get_total_shares_status`	股票总数情况
`get_debt_securities_issued`	债务证券发行业绩
`get_commercial_paper_balance`	企业票据证券未偿还余额
`get_short_term_bond_balance`	短期公司债未偿还余额
`get_corporate_bond_balance`	公司债未偿还余额
`get_new_capital_securities_balance`	新型资本证券未偿还余额
`get_contingent_capital_balance`	有条件资本证券未偿还余额
`get_auditor_opinion`	审计人员的审计意见
`get_audit_service_contract`	审计劳务签订情况
`get_non_audit_service_contract`	非监查劳务签订情况
`get_outside_director_status`	外部董事及其变动情况
`get_unregistered_exec_compensation`	未注册高管薪酬情况
`get_total_compensation_approval`	董事、监事的报酬限度批准情况
`get_compensation_by_type`	按类型支付报酬金额
`get_public_offering_fund_usage`	公开募集资金的使用明细
`get_private_placement_fund_usage`	私募资金的使用明细

财务信息（7个）

工具	说明
`get_single_company_accounts`	单一公司主要帐户
`get_multi_company_accounts`	多个公司主要帐户
`get_xbrl_document`	财务报表源文件（XBRL ZIP）
`get_full_financial_statement`	单一公司财务报表
`get_xbrl_taxonomy`	XBRL出租车房地产财务报表格式
`get_single_financial_index`	单一公司主要财务指标
`get_multi_financial_index`	多家公司的主要财务指标

股份公告（2个）

工具	说明
`get_major_stockholding`	大量拥有情况报告
`get_executive_stockholding`	高管、主要股东所有报告

关键事项报告（36个）

工具	说明
`get_asset_transfer_putback`	资产转让图（Footback选项）
`get_default_occurrence` 债务违约（破产）
`get_business_suspension`	停业
`get_rehabilitation_filing`	申请启动回生程序
`get_dissolution_event`	发生解散原因
`get_paid_capital_increase`	决定有偿增资
`get_free_capital_increase`	决定无偿增资
`get_mixed_capital_increase`	决定有偿增资
`get_capital_reduction`	土豆结晶
`get_creditor_management_start`	启动债权银行管理程序
`get_lawsuit_filing`	提起诉讼等
`get_overseas_listing_decision`	决定海外上市
`get_overseas_delisting_decision`	决定退市海外
`get_overseas_listing` 海外上市
`get_overseas_delisting`	海外退市
`get_convertible_bond_decision`	决定发行可转换债券
`get_bond_with_warrant_decision`	决定发行新股认购权副债券
`get_exchangeable_bond_decision`	决定发行交易所债券
`get_creditor_management_stop`	债权银行管理程序中断
`get_contingent_bond_decision`	决定发行有条件资本证券
`get_treasury_stock_acquisition_decision`	决定购买自己的股票
`get_treasury_stock_disposal_decision`	决定处置自己的股票
`get_treasury_trust_contract_decision`	决定签订自己的股份取得信托合同
`get_treasury_trust_termination_decision`	决定解除自己的股份取得信托合同
`get_business_acquisition_decision`	确定销售数量
`get_business_transfer_decision`	销售转让决定
`get_tangible_asset_acquisition_decision`	决定转让有形资产
`get_tangible_asset_transfer_decision`	决定转让有形资产
`get_other_corp_stock_acquisition_decision`	决定受让其他法人股份
`get_other_corp_stock_transfer_decision`	决定转让其他法人股份
`get_stock_bond_acquisition_decision`	决定受让股权相关公司债券
`get_stock_bond_transfer_decision`	决定转让股权相关公司债券
`get_merger_decision`	决定合并公司
`get_division_decision`	决定拆分公司
`get_division_merger_decision`	决定分拆合并公司
`get_stock_exchange_transfer_decision`	换股·搬迁决定

证券申报表（6个）

工具	说明
`get_equity_securities_reg`	股权证券
`get_debt_securities_reg` 债务证券
`get_depositary_receipts_reg` 证券存托证券
`get_merger_reg`	合并
`get_stock_exchange_reg`	全面换股·转让
`get_division_reg`	分割

主要参数

参数说明示例 |---|---|---| | corp_code |企业唯一编号（8位）| 00126380 （三星电子） | bsns_year |业务年度| 2024 | | reprt_code |报告代码| 11013 第一季度， 11012 半旗， 11014 第三季度， 11011 业务报告| | bgn_de / end_de |查询开始日期/结束日期（YYYYMMDD）| 20240101 / 20241231 | | rcept_no 受理号码（14位） 20240312000736 |

corp_code如果不知道 search_disclosure使用搜索企业名称或 get_corp_code可以通过查看完整列表。

使用示例

在MCP客户端（Claude等）上用自然语言提问即可：

“请在三星电子2024年事业报告中告知分红信息”
“请查询NAVER最大股东现状”
“展示2024年三星电子取得自己股份的决定明细”
“查询SK海力士2024年财务报表主要账户”
“告诉我Kakao高管的现状和薪酬信息”

许可证

麻省理工学院