OpenDART MCP

🇰🇷 Servidor MCP OpenDART

Dados de divulgação corporativa coreana para agentes de IA — desenvolvido com DART

A maneira mais fácil de entregar dados DART (Sistema de Divulgação Eletrônica) à IA.

Basta dizer "mostre as demonstrações financeiras da Samsung Electronics" a IAs compatíveis com MCP, como Claude Desktop e Cursor, e você receberá a resposta imediatamente.

⚡ Início rápido

Usar diretamente via npm (recomendado)

npx opendart-mcp

Pode ser usado diretamente nas configurações do Claude Desktop ou Cursor. Os códigos de registro corporativo são baixados automaticamente na primeira execução.

Instalação a partir do código-fonte

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

A chave da API DART pode ser obtida gratuitamente no OpenDART (10.000 requisições/dia).

🔧 Ferramentas fornecidas

💬 Exemplos de uso

"Me mostre as informações básicas da Samsung Electronics"

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

"Há alguma divulgação publicada hoje?"

전체 공시 검색 결과 (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건

"Me mostre a receita e o lucro operacional de 2023 da Kakao"

카카오 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%

📦 Guia detalhado de instalação

1. Obtenção da chave da API DART

1. Acesse OpenDART
2. Cadastre-se e faça login
3. Solicite a chave de autenticação → emissão da chave da API (imediata e gratuita)
4. Guarde a chave emitida

2. Instalação do projeto

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

3. Configuração das variáveis de ambiente

cp .env.example .env

Abra o arquivo .env e insira a chave da API emitida:

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

4. Download dos dados de código de registro corporativo (opcional)

npm run update-corp-codes

Esta etapa é opcional, pois os dados são baixados automaticamente na primeira execução do servidor. Execute apenas se quiser atualizar manualmente.

5. Build & execução

npm run build
npm start

⚙️ Configuração do cliente de IA

Claude Desktop (npx — recomendado)

Adicione em 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 (depuração)

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

🛠️ Contribuição para o desenvolvimento

# 빌드
npm run build

# 빌드 + 실행
npm run dev

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

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

Estrutura do projeto

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     # 금액 포매팅 헬퍼

Como contribuir

1. Fork → criar branch → commit → PR
2. Mensagem de commit: use o estilo Conventional Commits, como feat:, fix:, docs:, etc.
3. Não use console.log() (para evitar contaminação na transmissão stdio). Use apenas console.error()

📄 Licença

MIT — use, modifique e distribua livremente.

Este projeto utiliza dados públicos da DART OpenAPI da Comissão de Serviços Financeiros da Coreia.

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