OpenDart-MCP

Acesse a API DART (Data Analysis, Retrieval and Transfer System) para recuperação e análise detalhadas de informações financeiras.

GitHub

Experimente este MCPPatrocinado

Documentação

OpenDart-MCP

O OpenDart-MCP é uma biblioteca Python que fornece a API DART (Data Analysis, Retrieval and Transfer System) com base no Model-Context Protocol (MCP), permitindo acesso mais eficiente e padronizado a diversas funcionalidades de consulta e análise de informações financeiras.

Principais Funcionalidades

O OpenDart-MCP oferece, por meio do MCP, as seguintes funcionalidades detalhadas de consulta e análise de informações financeiras:

Consulta de informações básicas de empresas: Por meio da interface MCP, consulte rapidamente informações básicas detalhadas de uma empresa com base no nome ou código (nome da empresa, nome em inglês, código do ativo, nome do representante legal, tipo de entidade, número de registro da entidade, número de registro do CNPJ, endereço, site, site de RI, telefone, fax, data de fundação, mês de encerramento do exercício, etc.).
Consulta de demonstrações financeiras completas de uma única empresa: Utilize o MCP para solicitar as demonstrações financeiras originais (individuais/consolidadas, sistema de contas padrão XBRL) correspondentes a um ano fiscal e tipo de relatório específicos (relatório do 1º trimestre, relatório semestral, relatório do 3º trimestre, relatório anual) de uma empresa e receba dados processados em JSON, como balanço patrimonial, demonstração de resultados e demonstração de fluxo de caixa. (Suporta IFRS e GAAP)
Consulta de lista de demonstrações financeiras: Por meio do MCP, obtenha facilmente a lista de demonstrações financeiras divulgadas anteriormente por uma empresa, organizadas por ano e trimestre, com links para a consulta detalhada de cada demonstração.
Consulta de visão geral do passivo: Utilize o MCP para identificar rapidamente a visão geral do passivo da empresa com base no último exercício fiscal (itens detalhados e valores de passivo circulante e não circulante) para análise de solidez financeira.
Consulta de participações em outras entidades: Por meio do MCP, consulte detalhadamente as participações de uma empresa em outras entidades (nome da empresa investida, objetivo do investimento, data de aquisição inicial, valor de aquisição inicial, participação no início e no final do período, valor contábil, etc.) para analisar o portfólio de investimentos e a situação das empresas relacionadas.
Consulta de situação de diretores e funcionários: Por meio da interface MCP, consulte a situação dos diretores registrados e não registrados (nome, data de nascimento, cargo, classificação registrado/não registrado, período de mandato, etc.) e a situação dos funcionários (número de funcionários, tempo médio de serviço, salário anual total, salário médio por pessoa, incluindo informações detalhadas por setor/gênero) para entender a estrutura de pessoal e o estado operacional da empresa.
Consulta de número total de ações: Por meio do MCP, receba informações essenciais sobre as ações emitidas pela empresa, como número total de ações, classificação em ações ordinárias/preferenciais, número de ações em circulação, situação de ações em tesouraria, etc., para análise da estrutura de capital e liquidez de mercado.

Lista de Ferramentas Fornecidas (src/dart_mcp/tools)

find_company_by_name.py: Pesquisa de informações da empresa pelo nome
get_company_financial_stmt_list.py: Consulta da lista de demonstrações financeiras da empresa
get_debt_summary.py: Consulta da visão geral do passivo
get_financial_stmt.py: Consulta das demonstrações financeiras completas de uma única empresa
get_investment_summary.py: Consulta de participações em outras entidades
get_people_summary.py: Consulta da situação de diretores e funcionários
get_stock_summary.py: Consulta do número total de ações

Guia de Configuração do MCP

Guia passo a passo para usar o OpenDart-MCP no Claude Desktop.

1. Pré-requisitos

1.1 Obtenção da chave da API DART

Acesse o Sistema Eletrônico de Divulgação DART
Clique em 'OpenAPI' no canto superior direito
Siga 'Solicitação de API' → 'Registro de desenvolvedor'
Após inserir as informações pessoais, a chave da API será emitida (enviada por e-mail)
Salve a chave da API recebida em um bloco de notas

1.2 Instalação do Docker

Windows: Baixe e instale o Docker Desktop for Windows
macOS: Baixe e instale o Docker Desktop for Mac
Linux: Consulte o Guia de instalação do Docker adequado à sua distribuição

2. Criação da imagem Docker

# 1. 깃허브 복사하기
git clone https://github.com/keonho-kim/OpenDart-mcp.git

# 1. 프로젝트 폴더로 이동
cd OpenDart-mcp

# 2. Docker 이미지 빌드
docker build -t opendart-mcp .

Observação: O processo de criação pode levar alguns minutos.

3. Configuração do Claude Desktop

3.1 Localização do arquivo de configuração

Localização do arquivo de configuração do Claude Desktop por sistema operacional:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

3.2 Edição do arquivo de configuração

Abra o arquivo de configuração no caminho acima com um editor de texto (se o arquivo não existir, crie um novo)
Adicione o seguinte conteúdo ou modifique o conteúdo existente:

{
  "mcpServers": {
    "opendart-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--net=host",
        "-e",
        "DART_API_KEY=<PUT_YOUR_DART_API_KEY>",
        "opendart-mcp"
      ]
    }
  }
}

Substitua a parte <PUT_YOUR_DART_API_KEY> pela chave de API real obtida na etapa 1
- Exemplo: "DART_API_KEY=1234567890abcdef1234567890abcdef12345678"

3.3 Exemplo de arquivo de configuração (formato completo)

{
  "mcpServers": {
    "opendart-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--net=host",
        "-e",
        "DART_API_KEY=1234567890abcdef1234567890abcdef12345678",
        "opendart-mcp"
      ]
    }
  }
}

4. Reiniciar o Claude Desktop

Após salvar o arquivo de configuração, feche completamente o Claude Desktop e execute-o novamente.

5. Verificação de uso

Teste no Claude Desktop da seguinte forma:

삼성전자의 2023년 사업보고서를 조회해주세요.

OpenDart-MCP

Documentação

OpenDart-MCP

Principais Funcionalidades

Lista de Ferramentas Fornecidas (src/dart_mcp/tools)

Guia de Configuração do MCP

1. Pré-requisitos

1.1 Obtenção da chave da API DART

1.2 Instalação do Docker

2. Criação da imagem Docker

3. Configuração do Claude Desktop

3.1 Localização do arquivo de configuração

3.2 Edição do arquivo de configuração

3.3 Exemplo de arquivo de configuração (formato completo)

4. Reiniciar o Claude Desktop

5. Verificação de uso

Solução de Problemas

Erros relacionados ao Docker

Erros relacionados ao arquivo de configuração