OpenProxy MCP

License: CC BY-NC 4.0 Python 3.10+ MCP Tools

English README

为什么选择 OpenProxy？

治理风险是“韩国折扣”（Korea Discount）的核心。随着被动投资的增加，股票所有权的意义变得模糊，而这一风险反而变得更加清晰。我们需要能够轻松获取并快速分析治理信息，但阅读数百页的原始披露文件既耗时又缺乏专业性。

OpenProxy 通过 AI 打破了这一壁垒。 它将 DART 披露信息转化为结构化数据，让任何人都能在几秒钟内完成从股权结构、分红历史、股东大会议案到经营权争夺等全方位的治理分析。

OpenProxy MCP 比较

查看更多使用示例截图

快速开始

第 0 步：确认 Claude 订阅（必需）

MCP 连接器仅供 Claude Pro、Max、Teams 订阅者使用。请在 claude.ai 确认您的订阅状态。

第 1 步：申请 DART API 密钥（必需）

OpenProxy 的所有数据均来自 DART OpenAPI。您必须拥有自己的 API 密钥才能使用。

访问 DART OpenAPI -> 注册会员
申请认证密钥 -> 发放（免费，即刻发放）

第 2 步：连接

获取 API 密钥后，请选择以下两种方法之一。

方法 A：远程服务器（无需安装，30秒即可完成）

在 URL 末尾附加您获取的 DART API 密钥进行连接。密钥仅在服务器端使用，不会暴露给 AI。

claude.ai 网页版：

访问 claude.ai -> 设置 -> 连接器
选择“添加自定义连接器”
名称：open-proxy-mcp，输入 URL：

https://open-proxy-mcp.fly.dev/mcp?opendart=발급받은_키

点击“添加” -> 35 个工具将自动识别
在已添加连接器的配置 -> 权限中选择 “始终允许”（无需每次批准即可自动运行工具）

注意：如果工具被添加或更改，请删除连接器后重新连接，以反映最新工具。URL 和 API 密钥相同，只需重新连接即可。

方法 B：本地安装

在本地运行可以设置除 DART 之外的其他 API 密钥（如候选人新闻搜索、OCR 回退等）。

请参考本地安装指南

使用示例

连接完成后，您可以用自然语言提问：

"삼성전자 주주총회 안건 분석해줘"
"KB금융 사외이사 후보 독립성 검토해줘"
"현대차 보수한도 적정성 판단해줘"
"삼성전자 지분 구조 보여줘"
"SK하이닉스 배당 추이 알려줘"
"고려아연 경영권 분쟁 분석해줘"

请注意，OpenProxy 目前不分析 DART 的财务指标（即将更新）

Tool 架构（35个）

35 个工具分为 5 个层级（Tier）。AI 会按顺序从 Tier 1 开始调用，必要时会向下调用下级 Detail 工具。

Tier 1  corp_identifier ............. "005930" / "Samsung"
        |
Tier 2  tool_guide
        |
        +------------------+------------------+
        |                  |                  |
Tier 3  agm_search         div_search         proxy_search
        |                  |                  |
Tier 4  agm_pre_analysis   div_full_analysis  proxy_fight
        agm_post_analysis
        ownership_full_analysis
        governance_report
        |                  |                  |
        +------------------+------------------+
        |
Tier 5  AGM (12)                OWNERSHIP (5)
        agm_agenda_xml          ownership_major
        agm_financials_xml      ownership_total
        agm_personnel_xml       ownership_treasury
        agm_aoi_change_xml      ownership_treasury_tx
        agm_compensation_xml    ownership_block
        agm_treasury_share_xml
        agm_capital_reserve_xml DIVIDEND (2)
        agm_retirement_pay_xml  div_detail
        agm_result              div_history
        agm_items
        agm_corrections         PROXY (3)
        agm_parse_fallback      proxy_detail
                                proxy_direction
                                proxy_litigation
        NEWS (1)
        news_check              VALUE_UP (1)
                                value_up_plan

按领域分类摘要

领域	说明	工具数量
AGM	股东大会召集通知解析 -- 议案、财务报表、董事选任、章程变更、薪酬限额、库存股等	14
OWNERSHIP	股权结构 -- 最大股东、总股数、库存股、5% 大额持股人	6
DIVIDEND	分红分析 -- 分红详情、3年趋势、分红倾向/收益率	4
PROXY	经营权争夺 -- 委托书征集、双方比较、诉讼	5
VALUE_UP	企业价值提升计划（Value-up）披露	1
NEWS	候选人负面新闻搜索	1
CORP	企业识别（ticker/corp_code 转换）	1
GUIDE	全套工具使用指南	1
GOV	治理综合报告（AGM+OWN+DIV 整合）	1
	合计	35

表决权行使判断

当您请求对股东大会议案进行表决权行使判断时，系统会根据以下决策树提供赞成/反对/审查意见。

议案类型	FOR（赞成）	AGAINST（反对）	REVIEW（审查）
财务报表	审计意见无保留	保留/否定	分红倾向极端
董事选任	满足独立董事独立性	独立性不足	兼职 3 个以上、负面新闻
薪酬限额	消耗率合理	消耗率 < 30% 但要求上调	50%+ 大幅上调
章程变更	反映法律法规（形式上）	排除集中投票	缩减董事名额
库存股	以注销为目的	以防御经营权为目的	向基金会出资
分红	高于行业平均	利润增加但 DPS 下降	减额分红

关于各议案类型的详细标准、防御战术检测以及 2026 年商法修订的影响，请参考表决权行使判断标准详情。

数据来源

来源	用途	备注
DART OpenAPI	召集通知、事业报告、大额持股披露	必需（免费 API 密钥）
KRX KIND	股东大会表决权行使结果	网页爬取
Naver News API	候选人负面新闻搜索	可选（免费 API 密钥）
Naver Finance	股价、行业名称、分红行情	网页爬取

项目结构

open-proxy-mcp/
  open_proxy_mcp/
    server.py              # FastMCP 서버 (stdio + HTTP)
    tools/                 # 35개 tool (AGM/OWN/DIV/PRX/NEWS/CORP/GUIDE/GOV)
    dart/client.py         # DART API + KIND 크롤링 + 네이버 + rate limiter
  Dockerfile               # Fly.io 배포용 컨테이너
  fly.toml                 # Fly.io 설정 (nrt 리전, auto-suspend)
  wiki/                    # 도메인 지식 위키 (68페이지)

免责声明

OpenProxy 是一个将 DART 披露数据结构化并提供给 AI 的工具。AI 可能会产生幻觉（hallucination），并可能提供不准确的分析。AI 提出的意见不代表开发者或开发者所属团体的意见。分析结果仅供参考，投资决策或表决权行使的最终判断请务必经过原始披露文件核实及专家审查。

许可协议

CC BY-NC 4.0 -- 仅允许非商业用途

使用本项目代码和数据时请注明出处。不得用于商业目的。

open-proxy-mcp