OpenProxy MCP

README en inglés

¿Por qué OpenProxy?

En el núcleo del "Korea Discount" se encuentra el riesgo de gobernanza. Con el aumento de la inversión pasiva, el significado de la propiedad accionarial se está desdibujando y este riesgo es cada vez más evidente. Aunque es necesario acceder fácilmente a la información de gobernanza y analizarla rápidamente, falta tiempo y experiencia para leer y evaluar personalmente cientos de páginas de documentos de divulgación originales.

OpenProxy derriba esta barrera con IA. Hemos convertido las divulgaciones de DART en datos estructurados para que cualquiera pueda realizar un análisis completo de gobernanza en segundos, desde la estructura accionarial hasta el historial de dividendos, los puntos de la agenda de la junta general y las disputas por el control de gestión.

Ver más capturas de pantalla de ejemplos de uso

Inicio rápido

Paso 0: Verificar la suscripción a Claude (obligatorio)

El conector MCP solo puede ser utilizado por suscriptores de Claude Pro, Max y Teams. Por favor, verifica el estado de tu suscripción en claude.ai.

Paso 1: Obtener la clave API de DART (obligatorio)

Todos los datos de OpenProxy provienen de la API abierta de DART. Debes tener tu propia clave API para poder usarlo.

1. Accede a DART OpenAPI -> Regístrate.

2. Solicita una clave de autenticación -> Emisión (gratuita, se emite al instante).

Paso 2: Conexión

Una vez que hayas obtenido la clave API, elige uno de los dos métodos siguientes.

Método A: Servidor remoto (30 segundos sin instalación)

Conéctate añadiendo la clave API de DART obtenida al final de la URL. La clave solo se utiliza en el servidor y no se expone a la IA.

Web de claude.ai:

1. Accede a claude.ai -> Configuración -> Conectores.

2. Selecciona "Añadir conector personalizado".

3. Nombre: open-proxy-mcp, URL de entrada:

https://open-proxy-mcp.fly.dev/mcp?opendart=발급받은_키

4. Haz clic en "Añadir" -> Se reconocerán automáticamente 35 herramientas.

5. Configuración del conector añadido -> En permisos, selecciona "Permitir siempre" (las herramientas se ejecutarán automáticamente sin necesidad de aprobación cada vez).

Nota: Si se añaden o modifican herramientas, debes eliminar el conector y volver a conectarlo para que se reflejen las últimas actualizaciones. La URL y la clave API son las mismas, así que solo es necesario volver a conectar.

Método B: Instalación local

Si ejecutas localmente, puedes configurar claves API adicionales además de DART (búsqueda de noticias de candidatos, fallback de OCR, etc.).

Consulta la guía de instalación local.

Ejemplo de uso

Una vez finalizada la conexión, puedes preguntar en lenguaje natural:

"삼성전자 주주총회 안건 분석해줘"
"KB금융 사외이사 후보 독립성 검토해줘"
"현대차 보수한도 적정성 판단해줘"
"삼성전자 지분 구조 보여줘"
"SK하이닉스 배당 추이 알려줘"
"고려아연 경영권 분쟁 분석해줘"

• Ten en cuenta que OpenProxy actualmente no analiza los indicadores financieros de DART (próxima actualización).

Arquitectura de herramientas (35)

Las 35 herramientas están organizadas en 5 niveles (Tier). La IA llama a las herramientas desde el Nivel 1 en orden y, si es necesario, desciende a las herramientas de detalle inferiores.

Tier 1  corp_identifier ............. "005930" / "Samsung"
        |
Tier 2  tool_guide
        |
        +------------------+------------------+
        |                  |                  |
Tier 3  agm_search         div_search         proxy_search
        |                  |                  |
Tier 4  agm_pre_analysis   div_full_analysis  proxy_fight
        agm_post_analysis
        ownership_full_analysis
        governance_report
        |                  |                  |
        +------------------+------------------+
        |
Tier 5  AGM (12)                OWNERSHIP (5)
        agm_agenda_xml          ownership_major
        agm_financials_xml      ownership_total
        agm_personnel_xml       ownership_treasury
        agm_aoi_change_xml      ownership_treasury_tx
        agm_compensation_xml    ownership_block
        agm_treasury_share_xml
        agm_capital_reserve_xml DIVIDEND (2)
        agm_retirement_pay_xml  div_detail
        agm_result              div_history
        agm_items
        agm_corrections         PROXY (3)
        agm_parse_fallback      proxy_detail
                                proxy_direction
                                proxy_litigation
        NEWS (1)
        news_check              VALUE_UP (1)
                                value_up_plan

Resumen por dominio

Evaluación del ejercicio del derecho de voto

Cuando se solicita una evaluación sobre el ejercicio del derecho de voto en los puntos de la agenda de la junta general, se presentan opiniones de aprobación/rechazo/revisión siguiendo el árbol de decisiones a continuación:

Para conocer los criterios detallados por tipo de agenda, detección de tácticas de defensa y el impacto de la reforma de la Ley Comercial de 2026, consulta los Criterios detallados para el ejercicio del derecho de voto.

Fuentes de datos

Estructura del proyecto

open-proxy-mcp/
  open_proxy_mcp/
    server.py              # FastMCP 서버 (stdio + HTTP)
    tools/                 # 35개 tool (AGM/OWN/DIV/PRX/NEWS/CORP/GUIDE/GOV)
    dart/client.py         # DART API + KIND 크롤링 + 네이버 + rate limiter
  Dockerfile               # Fly.io 배포용 컨테이너
  fly.toml                 # Fly.io 설정 (nrt 리전, auto-suspend)
  wiki/                    # 도메인 지식 위키 (68페이지)

Descargo de responsabilidad

OpenProxy es una herramienta que estructura los datos de divulgación de DART para proporcionárselos a la IA. La IA puede generar alucinaciones y proporcionar análisis inexactos. Las opiniones presentadas por la IA no son las del desarrollador ni las de la organización a la que pertenece el desarrollador. Utiliza los resultados del análisis solo como referencia; para decisiones de inversión o el ejercicio del derecho de voto, asegúrate de revisar los documentos originales y consultar a expertos.

Licencia

CC BY-NC 4.0 -- Solo se permite el uso no comercial.

Al utilizar el código y los datos de este proyecto, por favor indica la fuente. No se puede utilizar con fines comerciales.