OpenProxy MCP

Englische README

Warum OpenProxy?

Im Kern des „Korea Discount“ liegt das Governance-Risiko. In einer Zeit, in der passives Investieren zunimmt und die Bedeutung von Aktienbesitz verblasst, wird dieses Risiko immer deutlicher. Es ist notwendig, Governance-Informationen leicht zugänglich zu machen und schnell analysieren zu können – doch es fehlt oft an Zeit und Fachwissen, um hunderte Seiten von Original-Offenlegungen selbst zu lesen und zu bewerten.

OpenProxy bricht diese Barrieren mit KI. Wir wandeln DART-Offenlegungen in strukturierte Daten um, sodass jeder innerhalb von Sekunden eine umfassende Governance-Analyse durchführen kann – von der Eigentümerstruktur über die Dividendenhistorie und Tagesordnungspunkte der Hauptversammlung bis hin zu Konflikten um die Unternehmenskontrolle.

Weitere Anwendungsbeispiele

Schnelleinstieg

Schritt 0: Claude-Abonnement prüfen (erforderlich)

Der MCP-Connector ist nur für Abonnenten von Claude Pro, Max oder Teams verfügbar. Bitte überprüfen Sie Ihren Abonnementstatus auf claude.ai.

Schritt 1: DART API-Schlüssel beantragen (erforderlich)

Alle Daten von OpenProxy stammen aus der DART OpenAPI. Sie benötigen einen eigenen API-Schlüssel, um den Dienst nutzen zu können.

1. Besuchen Sie DART OpenAPI -> Registrieren.

2. Beantragen Sie einen Authentifizierungsschlüssel -> Erhalt (kostenlos, sofortige Ausstellung).

Schritt 2: Verbindung herstellen

Sobald Sie den API-Schlüssel haben, wählen Sie eine der beiden folgenden Methoden:

Methode A: Remote-Server (in 30 Sekunden ohne Installation)

Verbinden Sie sich, indem Sie Ihren DART API-Schlüssel an das Ende der URL anhängen. Der Schlüssel wird nur auf dem Server verwendet und nicht an die KI weitergegeben.

claude.ai Web:

1. Gehen Sie zu claude.ai -> Einstellungen -> Connectors.

2. Wählen Sie "Custom Connector hinzufügen".

3. Name: open-proxy-mcp, URL eingeben:

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

4. Klicken Sie auf "Hinzufügen" -> 35 Tools werden automatisch erkannt.

5. Konfiguration des hinzugefügten Connectors -> Unter Berechtigungen "Immer erlauben" wählen (damit die Tools ohne erneute Bestätigung automatisch ausgeführt werden).

Hinweis: Wenn Tools hinzugefügt oder geändert werden, müssen Sie den Connector löschen und neu verbinden, damit die neuesten Tools übernommen werden. URL und API-Schlüssel bleiben gleich.

Methode B: Lokale Installation

Bei einer lokalen Ausführung können Sie neben DART auch zusätzliche API-Schlüssel konfigurieren (z. B. für die Suche nach negativen Nachrichten zu Kandidaten, OCR-Fallback usw.).

Siehe Anleitung zur lokalen Installation.

Anwendungsbeispiele

Sobald die Verbindung steht, können Sie Fragen in natürlicher Sprache stellen:

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

• Bitte beachten Sie, dass OpenProxy derzeit keine Finanzkennzahlen von DART analysiert (Update geplant).

Tool-Architektur (35 Tools)

Die 35 Tools sind in 5 Tiers unterteilt. Die KI ruft diese nacheinander ab, beginnend bei Tier 1, und greift bei Bedarf auf die detaillierten Tools darunter zu.

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

Zusammenfassung nach Domänen

Beurteilung der Stimmrechtsausübung

Wenn Sie um eine Beurteilung zur Stimmrechtsausübung bei Tagesordnungspunkten der Hauptversammlung bitten, werden Empfehlungen (dafür/dagegen/prüfen) basierend auf folgendem Entscheidungsbaum gegeben:

Für detaillierte Kriterien je Tagesordnungspunkt, Erkennung von Abwehrtaktiken und Auswirkungen der Handelsgesetzbuch-Reform 2026 siehe Details zu den Kriterien der Stimmrechtsausübung.

Datenquellen

Projektstruktur

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페이지)

Haftungsausschluss

OpenProxy ist ein Werkzeug, das DART-Offenlegungsdaten strukturiert und der KI zur Verfügung stellt. Die KI kann Halluzinationen erzeugen und ungenaue Analysen liefern. Die von der KI geäußerten Meinungen sind nicht die des Entwicklers oder der Organisation des Entwicklers. Die Analyseergebnisse dienen nur zu Referenzzwecken; für Investitionsentscheidungen oder die Ausübung von Stimmrechten ist zwingend eine Prüfung der Original-Offenlegungen sowie eine Expertenberatung erforderlich.

Lizenz

CC BY-NC 4.0 – Nur nicht-kommerzielle Nutzung gestattet.

Bitte geben Sie die Quelle an, wenn Sie den Code und die Daten dieses Projekts verwenden. Eine kommerzielle Nutzung ist nicht gestattet.