OpenDart-MCP

Accede a la API de DART (Data Analysis, Retrieval and Transfer System) para la recuperación y análisis detallado de información financiera.

GitHub

Prueba este MCPPatrocinado

Documentación

OpenDart-MCP

OpenDart-MCP es una biblioteca de Python que proporciona la API de DART (Data Analysis, Retrieval and Transfer System) basada en el Protocolo de Contexto de Modelo (MCP), permitiendo acceder de manera más eficiente y estandarizada a diversas funciones de consulta y análisis de información financiera.

Funciones principales

OpenDart-MCP ofrece las siguientes funciones detalladas de consulta y análisis de información financiera a través de MCP:

Consulta de información básica de empresas: A través de la interfaz MCP, consulta rápidamente información básica detallada de una empresa (nombre de la empresa, nombre en inglés, código del valor, nombre del representante, tipo de entidad, número de registro corporativo, número de registro comercial, dirección, sitio web, sitio web de IR, número de teléfono, número de fax, fecha de fundación, mes de cierre fiscal, etc.) basada en un nombre o código de empresa específico.
Consulta de estados financieros completos de una sola empresa: Utilizando MCP, solicita los estados financieros originales (individuales/consolidados, sistema estándar de cuentas XBRL) correspondientes a un año fiscal específico y tipo de informe (informe del primer trimestre, informe semestral, informe del tercer trimestre, informe anual) de una empresa específica, y recibe datos procesados en formato JSON como el balance general, estado de resultados y estado de flujos de efectivo. (Compatible con IFRS y GAAP)
Consulta de lista de estados financieros: A través de MCP, obtén fácilmente la lista de estados financieros anteriores divulgados por una empresa específica, organizados por año y trimestre, y proporciona un enlace para la consulta detallada de cada estado financiero.
Consulta de resumen de pasivos: Utilizando MCP, identifica rápidamente el resumen de pasivos de una empresa (partidas detalladas y montos de pasivos corrientes y no corrientes) basado en el año fiscal más reciente, para su uso en el análisis de solidez financiera.
Consulta de inversiones en otras entidades: A través de MCP, consulta en detalle la información sobre inversiones de una empresa específica en otras entidades (nombre de la empresa receptora, propósito de la inversión, fecha de adquisición inicial, monto de adquisición inicial, porcentaje de participación inicial y final, valor contable, etc.) para analizar la cartera de inversiones y el estado de las empresas relacionadas.
Consulta de ejecutivos y empleados: A través de la interfaz MCP, consulta el estado de los ejecutivos registrados y no registrados (nombre, fecha de nacimiento, cargo, clasificación registrado/no registrado, período de servicio, etc.) y el estado de los empleados (número de empleados, promedio de años de servicio, salario anual total, salario promedio por persona, incluyendo información detallada por división de negocio/género) para comprender la estructura de personal y el estado operativo de la empresa.
Consulta de número total de acciones: A través de MCP, recibe información clave relacionada con las acciones emitidas por la empresa, como el número total de acciones, clasificación en acciones ordinarias/preferentes, número de acciones en circulación, estado de acciones propias, etc., para su uso en el análisis de la estructura de participación y liquidez del mercado.

Lista de herramientas proporcionadas (src/dart_mcp/tools)

find_company_by_name.py: Búsqueda de información de empresa por nombre
get_company_financial_stmt_list.py: Consulta de lista de estados financieros de la empresa
get_debt_summary.py: Consulta de resumen de pasivos
get_financial_stmt.py: Consulta de estados financieros completos de una sola empresa
get_investment_summary.py: Consulta de inversiones en otras entidades
get_people_summary.py: Consulta de ejecutivos y empleados
get_stock_summary.py: Consulta de número total de acciones

Guía de configuración de MCP

Guía paso a paso para usar OpenDart-MCP en Claude Desktop.

1. Requisitos previos

1.1 Obtención de la clave API de DART

Acceda al Sistema Electrónico de Divulgación DART
Haga clic en 'OpenAPI' en la esquina superior derecha
Proceda con 'Solicitud de API' → 'Registro de desarrollador'
Ingrese la información personal y reciba la clave API (enviada por correo electrónico)
Guarde la clave API recibida en un bloc de notas

1.2 Instalación de Docker

Windows: Descargue e instale Docker Desktop for Windows
macOS: Descargue e instale Docker Desktop for Mac
Linux: Consulte la Guía de instalación de Docker correspondiente a su distribución

2. Creación de la imagen Docker

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

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

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

Nota: El proceso de creación puede tardar unos minutos.

3. Configuración de Claude Desktop

3.1 Ubicación del archivo de configuración

Ubicación del archivo de configuración de Claude Desktop según el sistema operativo:

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 Modificación del archivo de configuración

Abra el archivo de configuración en la ruta anterior con un editor de texto (si no existe, créelo)
Agregue el siguiente contenido o modifique el contenido existente:

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

Reemplace la parte <PUT_YOUR_DART_API_KEY> con la clave API real obtenida en el paso 1
- Ejemplo: "DART_API_KEY=1234567890abcdef1234567890abcdef12345678"

3.3 Ejemplo de archivo de configuración (forma completa)

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

4. Reinicio de Claude Desktop

Después de guardar el archivo de configuración, cierre completamente Claude Desktop y vuelva a ejecutarlo.

5. Verificación de uso

Pruebe lo siguiente en Claude Desktop:

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

OpenDart-MCP

Documentación

OpenDart-MCP

Funciones principales

Lista de herramientas proporcionadas (src/dart_mcp/tools)

Guía de configuración de MCP

1. Requisitos previos

1.1 Obtención de la clave API de DART

1.2 Instalación de Docker

2. Creación de la imagen Docker

3. Configuración de Claude Desktop

3.1 Ubicación del archivo de configuración

3.2 Modificación del archivo de configuración

3.3 Ejemplo de archivo de configuración (forma completa)

4. Reinicio de Claude Desktop

5. Verificación de uso

Solución de problemas

Errores relacionados con Docker

Errores relacionados con el archivo de configuración