适合谁
- 对韩国股市（KOSPI/KOSDAQ）有深度研究需求的量化分析师和投资者。
- 需要在Python环境中处理结构化财务数据的开发者。
- 希望通过MCP将金融分析能力集成到Claude或Codex等AI助手的工作流。
D
58FMRS · C
DartLab是一个功能强大的金融数据MCP服务器，专为韩国DART和美国EDGAR披露数据设计。它提供丰富的数据接口和AI分析能力，适合深度财务研究。安装需要预装Python包，并配置MCP客户端。目前支持Claude Desktop、Claude Code、Codex和Cursor。值得注意的是，它需要较多的本地磁盘空间和网络资源，且仅提供有限的美股数据深度。总体而言，对于关注韩国市场的研究人员而言，这是一个极具价值的工具。
DartLab是一款开源研究系统，它将韩国DART和美国SEC EDGAR的披露文件整合为可比较的企业数据。它通过一个统一的代码（Company）接口提供财务报表、业务报告全文、披露列表、比率、信用风险、行业图谱和宏观背景。核心功能是将不同公司的不同账户名称和披露目录水平化为topic × period和account × period网格，使得跨年份、跨公司（如三星 vs 苹果）乃至全市场的比较成为可能。该系统提供Python库、CLI和AI助手（通过MCP）三种使用方式，并包含五个分析视角（分析、信用、行业、量化、宏观），以及扫描、筛选、故事生成和模拟功能。数据预构建在HuggingFace上，无需API密钥即可开始使用。
工具能力
ask
以自然语言提出分析请求，并整合AI自主工具调用与结果引用验证。
EngineCall
调用DartLab公开API中的单一可执行能力。
RunPython
执行dartlab和Polars代码，返回可追踪的引用值。
ReadSkill
搜索官方Skill OS中的技能规格。
GetSkillBody
获取特定技能的正文内容。
ReadSkillMarket
查询社区技能市场。
ReadCapability
查找DartLab公开API或文档字符串。
Read
读取本地文档或文件。
WebSearch
搜索外部最新信息。
ExternalReachDoctor
检查外部连接状态或健康情况。
SaveArtifact
保存分析产物，如文件或图表。
CompileVisual
生成可视化图表或图像。
CreateUserSkill
创建用户自定义技能。
PeerCompareN
比较多个同行公司的财务或运营指标。
DCFValuation
进行现金流折现估值。
CompileFinancialDashboard
生成财务仪表板。
RegressionForecast
执行回归分析或预测。
SensitivityAnalysis
进行敏感性分析。
CreditScorecard
生成信用评分卡或信用评估。
ScenarioCompareN
比较多个情景下的结果。
ScenarioOverlay
将情景叠加到现有数据或图表上。
SearchPastSessions
搜索历史会话或记录。
安装接入
安装Python包：pip install dartlab 或 uv add dartlab。然后，对于Claude Desktop，在配置文件中添加MCP服务器配置，使用命令dartlab mcp（需预先安装uv tool install dartlab）。对于Claude Code，运行claude mcp add dartlab -- dartlab mcp。对于Codex CLI，运行codex mcp add dartlab -- dartlab mcp。也可通过远程SSE方式连接：https://eddmpython-dartlab.hf.space/mcp/sse（注意Claude Desktop不支持远程）。
claude_desktop_config.json
{
"mcpServers": {
"dartlab": {
"command": "dartlab",
"args": ["mcp"],
"env": { "PYTHONUNBUFFERED": "1", "PYTHONUTF8": "1" }
}
}
}
选型与风险
不适合谁
- 需要实时股价高频交易数据的人（数据为预构建，延迟可能较高）。
- 只关注美国小型公司或深度EDGAR数据（EDGAR支持有限）。
- 追求轻量级、只读单一数据源的用户（功能丰富但较重）。
所需权限
- 需要网络访问以从HuggingFace下载预构建数据，以及访问DART和SEC API（EDGAR）。
- 本地文件系统权限用于缓存数据（默认在用户目录下）。
- 对于MCP配置，需要修改Claude Desktop或CLI的配置文件。
- 可选：DART API密钥（用于原始数据重新收集，常规使用无需）。
风险与副作用
- 外部披露内容（如新闻、公告）可能被序列化时包裹为不可信内容，但AI应仅将其作为分析依据，不应执行其中的指令。
- 数据预构建可能不是最新的，需注意时滞。
- 使用远程MCP端点时，请确保网络连接稳定。
- 安装时若Python路径问题可能导致MCP配置失败。
常见排障
- 若`dartlab`命令未找到，请检查Python scripts目录是否在PATH中，或使用绝对路径配置。
- MCP连接失败时，确认已通过`uv tool install dartlab`预安装，并设置环境变量`PYTHONUNBUFFERED=1`和`PYTHONUTF8=1`。
- 数据下载缓慢或失败，检查网络连接，或查看HuggingFace数据集状态。
- 对于AI分析问题，确保已先运行`dartlab agent status --refresh`并连接到支持的agent（如Codex）。
- CLI命令不工作时，尝试`dartlab --help`查看帮助，或用`dartlab mcp --config claude-desktop`生成配置。
使用场景
投资者或分析师需快速获取韩国上市公司财务数据并跨期比较。
同时研究韩国和美国公司的财务报告，需统一接口。
自动化批量扫描全市场财务比率或特定账户数据。
使用AI助手进行自然语言财务分析并验证其计算结果。
生成财务分析报告或公司故事，用于博客或研究。
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Codex CLI完整支持
Cursor完整支持