OpenDART MCP

🇰🇷 OpenDART MCP Server

Datos de divulgación corporativa de Corea para agentes de IA — impulsado por DART

La forma más fácil de pasar datos de DART (Sistema Electrónico de Divulgación) a la IA.

Con agentes compatibles con MCP como Claude Desktop o Cursor, puedes decir "muéstrame los estados financieros de Samsung Electronics" y obtener la respuesta de inmediato.

⚡ Inicio rápido

Uso directo con npm (recomendado)

npx opendart-mcp

Puedes usarlo directamente en la configuración de Claude Desktop o Cursor. El código único de empresa se descarga automáticamente en la primera ejecución.

Instalación desde el código fuente

git clone https://github.com/SongHyojun0228/opendart-mcp-server.git
cd opendart-mcp-server
npm install
npm run build && npm start

Puedes obtener una clave API de DART de forma gratuita en OpenDART (10,000 solicitudes por día).

🔧 Herramientas disponibles

💬 Ejemplos de uso

"Dame información básica de Samsung Electronics"

삼성전자(주) (SAMSUNG ELECTRONICS CO,.LTD)
────────────────────────────────────────
종목코드: 005930 (유가증권시장상장법인)
대표이사: 전영현, 노태문
법인구분: 유가증권시장상장법인
설립일: 1969-01-13
결산월: 12월
홈페이지: https://www.samsung.com/sec
주소: 경기도 수원시 영통구 삼성로 129 (매탄동)

"¿Hay divulgaciones publicadas hoy?"

전체 공시 검색 결과 (2026-01-14 ~ 2026-02-13)
────────────────────────────────────────

[기타공시] 투자판단관련주요경영사항 (2026-02-13)
  https://dart.fss.or.kr/dsaf001/main.do?rcpNo=20260213801610
[주요사항] 주요사항보고서(유상증자결정) (2026-02-13)
  https://dart.fss.or.kr/dsaf001/main.do?rcpNo=20260213000234
...
총 847건

"Dame los ingresos y ganancias operativas de Kakao en 2023"

카카오 2023년 연간 재무 요약 (연결)
────────────────────────────────────────
매출액         7조 5,570억원 (+11.2%)
영업이익        4,609억원 (-19.1%)
당기순이익       -1조 8,167억원 (-270.3%)
────────────────────────────────────────
자산총계        25조 1,800억원
부채총계        11조 3,214억원
자본총계        13조 8,586억원
────────────────────────────────────────
부채비율      81.7%

📦 Guía de instalación detallada

1. Obtener la clave API de DART

1. Accede a OpenDART
2. Regístrate e inicia sesión
3. Solicita la clave de autenticación → Emisión de clave API (inmediata y gratuita)
4. Guarda la clave emitida

2. Instalación del proyecto

git clone https://github.com/SongHyojun0228/opendart-mcp-server.git
cd opendart-mcp-server
npm install

3. Configuración de variables de entorno

cp .env.example .env

Abre el archivo .env e ingresa la clave API emitida:

DART_API_KEY=여기에_발급받은_키_입력

4. Descarga de datos de códigos únicos de empresa (opcional)

npm run update-corp-codes

Este paso es opcional, ya que los datos se descargan automáticamente en la primera ejecución del servidor. Ejecútalo solo si deseas actualizarlos manualmente.

5. Compilación y ejecución

npm run build
npm start

⚙️ Configuración del cliente de IA

Claude Desktop (npx — recomendado)

Agrega a claude_desktop_config.json:

{
  "mcpServers": {
    "opendart": {
      "command": "npx",
      "args": ["-y", "opendart-mcp"],
      "env": {
        "DART_API_KEY": "발급받은_키"
      }
    }
  }
}

{
  "mcpServers": {
    "opendart": {
      "command": "node",
      "args": ["/절대경로/opendart-mcp-server/dist/src/index.js"],
      "env": {
        "DART_API_KEY": "발급받은_키"
      }
    }
  }
}

Cursor

Cursor Settings → MCP → Add Server:

{
  "mcpServers": {
    "opendart": {
      "command": "npx",
      "args": ["-y", "opendart-mcp"],
      "env": {
        "DART_API_KEY": "발급받은_키"
      }
    }
  }
}

MCP Inspector (depuración)

npx @modelcontextprotocol/inspector node dist/src/index.js

🛠️ Contribución al desarrollo

# 빌드
npm run build

# 빌드 + 실행
npm run dev

# 기업 고유번호 업데이트
npm run update-corp-codes

# MCP Inspector로 테스트
npx @modelcontextprotocol/inspector node dist/src/index.js

Estructura del proyecto

src/
├── index.ts              # FastMCP 서버 진입점
├── tools/
│   ├── disclosure.ts     # search_company, search_disclosures
│   └── financial.ts      # get_financial_summary, compare_financials, get_full_financial_statements
└── utils/
    ├── dart-client.ts    # DART API HTTP 클라이언트
    ├── corp-code.ts      # 회사명/종목코드 → 고유번호 변환
    └── formatters.ts     # 금액 포매팅 헬퍼

Cómo contribuir

1. Fork → Crear rama → Commit → PR
2. Mensajes de commit: feat:, fix:, docs:, etc., siguiendo el estilo Conventional Commits
3. No usar console.log() (para evitar contaminación de la transmisión stdio). Usar solo console.error()

📄 Licencia

MIT — Puedes usar, modificar y distribuir libremente.

Este proyecto utiliza datos públicos de la DART OpenAPI de la Comisión de Servicios Financieros.

English

OpenDART MCP Server

Korean corporate disclosure data for AI agents — powered by DART

MCP server that connects Korea's DART (Electronic Disclosure System) to AI agents like Claude, ChatGPT, and Cursor.

Ask your AI "What's Samsung Electronics' revenue?" and get real answers from official Korean financial filings.

Available Tools

Quick Start

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "opendart": {
      "command": "npx",
      "args": ["-y", "opendart-mcp"],
      "env": {
        "DART_API_KEY": "your_api_key"
      }
    }
  }
}

Get your free DART API key at opendart.fss.or.kr. Corp code data is automatically downloaded on first run.

License

MIT