这个项目能做什么

open-esg-korea 是一个 MCP (Model Context Protocol) 服务器，允许 AI 客户端通过自然语言直接查询韩国上市公司的 ESG 信息。该项目由证券分析师开发，采用了与 open-proxy-mcp (DART 公示分析) 相同的结构。 ■ 数据来源与方式 该服务器整合了 KRX ESG 门户中 5 家机构 (KCGS、MSCI、韩国 ESG 研究院、S&P、Sustinvest) 的 ESG/E/S/G 等级和企业治理核心指标；KIND 公示中的企业治理报告和可持续经营报告原文 (提取 PDF 正文)；以及 GIR 温室气体综合信息中心的温室气体明细书和排放权交易制信息。这三个来源均无需 API 密钥，等级数据不进行存储，而是在提问时实时获取。所有数值均附带来源、年份和使用条件。 ■ 安装 用户可从 Release 页面下载适用于相应平台的 .mcpb 文件 (macOS Apple Silicon/Intel 约 40-44MB, Windows x64 约 43MB)，将其拖放到 Claude Desktop 的“设置 → 扩展”界面即可完成安装。由于内置了 Python 运行时，因此无需安装 Python、开发工具或 API 密钥。目前暂无 Linux 捆绑包，对于 ChatGPT 用户，则引导通过 Codex (CLI/IDE 扩展/App) 连接 MCP 服务器。安装文件中包含运行时、依赖项 (mcp, httpx, pypdfium2, pdfplumber)、服务器主体、清单文件和构建信息。 ■ 12 个工具 company (查询公司名/代码)、esg_ratings (各机构等级及其分布)、sustainability_reports (报告列表/验证机构/PDF 地址)、sustainability_report_text (PDF 正文关键词搜索/摘录/页码查看)、governance_indicators (15 个核心指标 O/X 及遵守率)、governance_policies (74 个政策项目)、governance_report (报告原文, 28 个详细原则的回答及未遵守理由)、esg_disclosures (公示历史)、esg_screener (有价证券整体等级筛选器, 以 2025 年 795 家公司为准)、ghg_emissions (公司排放量/5 年趋势/相对于配额的情况)、ghg_industry (指定行业/法人排放量排名)、ghg_national_inventory (1990 年起国家清单时间序列)。 ■ 阅读注意事项 由于各机构的等级量表不同，建议不要直接横向比较 (KCGS S~D, MSCI AAA~CCC, S&P 0-100分, Sustinvest AA~E)。“-”表示未评估，而非 0 分或差评。由于等级仅分 6-7 级，同分较多，因此不提供“前 N%”排名，而是在同一机构内进行计数回答。行业体系在 GICS 工业群 (25 个)、门户行业 (21 个) 和 GIR 指定行业之间存在差异。KOSDAQ 仅提供等级表。治理方面分为 KRX 统计和公司撰写的原文两层，若无法读取原文，将区分标注为“无法读取”而非“0 个遵守”。温室气体部分优先提供范围 (边界、Scope 2 方式、是否包含 NF₃)，若 GIR 中无数据则显示为 no_data。报告数值的自动表格提取处于实验阶段 (值保留率 97.4%，可疑单元格会发出警告)，PDF 搜索会忽略字间空格，且无法读取无 OCR 的图像 PDF。接收入号为 KIND 编号，与 DART 查看器不同。 ■ 许可注意事项 代码采用 Apache-2.0 协议，允许包括商业用途在内的自由使用、修改和分发，条件是标注来源。但此协议不适用于服务器读取的数据。ESG 等级属于各评估机构的著作物，且五家机构均禁止对外公开，因此若要收集、存储、重新分发、转售等级或将其产品化，必须先咨询相关机构。为此，服务器除内存缓存外不保留等级数据，并要求不要删除响应中的 license 字段。 ■ 开发者指南 可通过 uv 安装依赖，然后运行 python -m open_esg_korea (HTTP, localhost:8000/mcp) 或使用 --transport stdio，并在 claude_desktop_config.json 中注册以实现本地连接。可使用 scripts/build_mcpb.py 直接构建各平台扩展，并通过 --check 验证 12 个工具是否响应。测试可通过 pytest 在无网络环境下运行。项目还提供 GICS 分类和上市公司名单快照更新脚本及工作流，检查 KRX 响应模式和 KIND 公示访问的 probe/smoke 脚本，以及 MCP 草案和实测笔记文档。