Mopsfin Taiwan-Aktien MCP Server

Öffentlicher, schreibgeschützter, datenbankfreier MCP-Server für Finanzdaten taiwanischer Unternehmen. Der Dienst ist mit Next.js 16 App Router und dem MCP TypeScript SDK v2 implementiert und stellt über Stateless Streamable HTTP /api/mcp sieben Tools bereit; jede Finanzabfrage greift direkt auf 公開資訊觀測站－財務比較 E 點通 zu.

Dies ist kein offizieller MCP-Server der Taiwan Stock Exchange und stellt keine Anlageberatung dar.

Architektur

LLM / MCP client
       │ Streamable HTTP
       ▼
Next.js /api/mcp on Vercel
       │ 固定 allowlist endpoint、form-urlencoded、無 cookie
       ▼
mopsfin.twse.com.tw
       │
       ├─ JSON → periods + series
       └─ HTML → 展開 rowspan/colspan 的二維 tables

• Keine Datenbank, kein Redis und kein veralteter HTTP+SSE-Transport.

• Finanzdaten werden nicht zwischengespeichert; nur das aus der Startseite geparste dynamische Verzeichnis wird im Speicher einer einzelnen Vercel-Instanz für 5 Minuten gecacht.

• Die Upstream-URLs sind vollständig fest verdrahtet; Tool-Parameter können keine URLs liefern, sodass kein beliebiger Proxy/SSRF entsteht.

• Upstream-Timeout 20 Sekunden; Netzwerkfehler, 429, 5xx werden nur einmal wiederholt, andere 4xx werden nicht wiederholt.

• Mopsfin-Cookies werden weder gespeichert noch weitergeleitet.

• latest eines Berichts wird vom letzten abgeschlossenen Quartal rückwärts über maximal 12 Quartale sondiert und die Antwortperiode wird geprüft, um ein stilles Zurückfallen der Originalseite auf andere Quartale zu vermeiden.

• Vercel verwendet Node.js 24.x, Tokio hnd1, 60 Sekunden Function-Duration und Fluid Compute.

Related MCP server: polygon-mcp

MCP-Tools

Jedes Tool hat ein striktes Zod-Input/Output-Schema und gibt eine kurze content-Zusammenfassung sowie vollständiges structuredContent zurück. Tool-Annotationen kennzeichnen die Tools als schreibgeschützt, nicht destruktiv, idempotent und ohne Open-World-Nebenwirkungen.

LLMs können Interpretationsdaten aus drei Ebenen beziehen: Die Server-Instructions von MCP initialize beschreiben den gesamten Datenumfang und die Aufrufreihenfolge; tools/list liefert für die sieben Tools und jedes Input/Output-Feld Zweck und Definition; list_catalog liefert mit officialGuidance und dem guidance jedes Metriks Formeln, Wertebasis, anwendbare Branchen und Hinweise. Die warnings der tatsächlichen Abfrageergebnisse enthalten zusätzlich direkt auf die Abfrage bezogene Hinweise zu Meldefrequenz, Einzelquartal／kumuliert, fehlenden Werten, Durchschnittswerten oder Paginierung.

Wenn der Code unbekannt ist, rufen Sie zuerst find_companies oder list_catalog auf. Die family-Werte von list_catalog entsprechen wie folgt:

Trends geben standardmäßig die letzten 12 Quartale zurück, optional mit start_period, end_period oder history: "all". Große HTML-Tabellen werden mit offset, limit paginiert, Standard 100 Zeilen, Maximum 500 Zeilen. Das Periodenformat ist YYYYQn.

Unternehmenskennzahlen können mit include_industry_average, include_company_average um den Branchendurchschnitt und den einfachen Durchschnitt ausgewählter Unternehmen ergänzt werden; Kennzahlen von Finanzinstituten können mit include_industry_average, include_institution_average um den Durchschnitt der jeweiligen Finanzbranche und den einfachen Durchschnitt ausgewählter Institute ergänzt werden. Diese Durchschnittswerte werden von Mopsfin berechnet und sind nicht marktkapitalisierungsgewichtet.

Bei der Beantwortung von Datenfragen sollten mindestens unit, die tatsächlichen periods／period, die Abfrage-basis und warnings erhalten bleiben. null, NO_DATA oder ein fehlendes Quartal können bedeuten, dass die Angabe nicht anwendbar ist, noch nicht gemeldet wurde oder in diesem Markt nicht gemeldet werden muss; sie dürfen nicht in 0 umgeschrieben werden.

Lokale Entwicklung

Voraussetzungen: Node.js 24, npm 11.

npm install
npm run dev

Dienste:

• Startseite: http://localhost:3000/

• MCP: http://localhost:3000/api/mcp

• Health-Check: http://localhost:3000/api/health

Der Health-Check ruft Mopsfin nicht auf, um zu vermeiden, dass Monitoring-Traffic zu einer festen Abfrage der Originalseite wird.

Verifizierung mit dem offiziellen MCP Inspector oder dem mitgelieferten Client:

npm run test:client
# 或指定 Preview URL
npm run test:client -- https://your-preview.vercel.app/api/mcp

Beispiel für eine MCP-Client-Konfiguration:

{
  "mcpServers": {
    "mopsfin": {
      "url": "https://your-domain.example/api/mcp"
    }
  }
}

Verwendung in ChatGPT

ChatGPT benötigt eine erreichbare öffentliche HTTPS-/api/mcp-URL; lokales localhost kann nicht direkt an entferntes ChatGPT übergeben werden.

1. Zuerst auf Vercel deployen und https://<Ihre-Domain>/api/mcp erhalten.

2. In ChatGPT Settings → Security and login → Developer mode aktivieren.

3. Zu ChatGPT Plugins gehen und mit dem Pluszeichen eine neue Verbindung hinzufügen.

4. Einen Namen eingeben, z. B. Mopsfin 台股, und die Connection URL auf die vollständige https://<Ihre-Domain>/api/mcp setzen.

5. Nach der Erstellung prüfen, ob ChatGPT die sieben Tools erkennt.

6. Ein neues Gespräch beginnen, diese MCP-Verbindung aus dem Tool-Menü hinzufügen und dann direkt in natürlicher Sprache nach taiwanischen Aktien fragen.

Ob der Developer mode verfügbar ist, hängt vom Kontoplan und der Workspace-Richtlinie ab. Detaillierte Schritte finden Sie in der offiziellen OpenAI-Verbindungsanleitung.

Beispielfragen:

• „Ermittle die Betriebseinnahmen von TSMC für die letzten 12 Quartale, stelle sie in einer Tabelle dar und weise auf Trends hin."

• „Vergleiche die ROE von TSMC und MediaTek für die letzten 8 Quartale."

• „Liste die Hauptpositionen der Bilanz von TSMC für 2025Q4 auf."

• „Vergleiche den Umsatztrend der Halbleiterbranche für die letzten 12 Quartale."

• „Ermittle die aktuell verfügbare Kapitaladäquanzquote des Bankensektors für die Bank of Taiwan."

Verifizierung

npm run lint
npm run type-check
npm test
npm run build

Allgemeine Tests verwenden nur feste Fixtures und decken 53 compareItem-Kategorien, sechs Endpoint-Familien, fehlende Werte, negative Zahlen, Prozentsätze, mehrere Unternehmen, HTML-Zellenverbünde, Paginierung, Timeout, 429, 5xx, fehlerhafte Quartale sowie MCP initialize/tools/list/tools/call ab.

Live-Contract-Tests sind standardmäßig übersprungen und fragen die Originalseite nur bei expliziter Aktivierung ab:

npm run test:live

Bitte keine Live-Tests als zeitgesteuertes CI einrichten, um festen Traffic auf Mopsfin zu vermeiden.

Deployment auf Vercel

1. Das Repository in Vercel importieren.

2. Build-Command npm run build verwenden; Vercel führt die npm-Installation gemäß package-lock.json aus.

3. package.json fixiert Node.js 24.x; vercel.json aktiviert Fluid Compute.

4. Nach dem Deployment mit npm run test:client -- https://<preview>/api/mcp abnehmen.

5. Je nach öffentlichem Traffic geeignete Regeln in der Vercel Firewall festlegen; die Anwendung selbst erstellt keine instanzübergreifende Rate-Limit-Datenbank.

Empfohlene Preview-Abnahme: TSMC-Umsatz der letzten 12 Quartale, ROE von TSMC und MediaTek, Bilanz für ein bestimmtes Quartal, Halbleiterbranchentrend, Kapitaladäquanzquote der Bank of Taiwan sowie Finanzberichtsanhänge von TSMC.

Fehlercodes

• INVALID_ARGUMENT

• NOT_FOUND

• NO_DATA

• UPSTREAM_TIMEOUT

• UPSTREAM_RATE_LIMITED

• UPSTREAM_BAD_RESPONSE

Die Meldequartale unterscheiden sich je nach Marktsegment: Börsennotierte／Oberlisten-Unternehmen haben in der Regel Q1–Q4, Emergent- und öffentlich emittierende Unternehmen möglicherweise nur Q2/Q4, einige Unternehmen melden nur jährlich. NO_DATA bedeutet nicht zwangsläufig, dass das Unternehmen nicht existiert.

Datenquellen, Aktualisierung und Nutzungsbedingungen

Die einzige Datenquelle ist Mopsfin. Gemäß der Nutzungshinweise der Website werden die Websitedaten einmal täglich aktualisiert und können etwa einen Tag hinter der Meldung zurückliegen; dieser Dienst verwendet keine Test-Fixtures als offizielle Daten oder Fallback.

Vor der öffentlichen Veröffentlichung muss der Projekteigentümer selbst die Genehmigung von TWSE/Mopsfin für öffentliches Proxying, Weiterverbreitung und Nutzungshäufigkeit prüfen. Die Beschreibung von Datenumfang und Aktualisierungshäufigkeit in den Nutzungshinweisen der Website entspricht keiner ausdrücklichen Erteilung des Rechts zur Weiterverbreitung. Nutzer sollten außerdem die ursprünglichen Meldungen des öffentlichen Informationsobservatoriums als letzte Prüfinstanz verwenden.

Wichtige Referenzen

• OpenAI: Build an MCP server

• Vercel: MCP for Next.js

• Next.js 16 upgrade guide

• Vercel Node.js versions

• Vercel Fluid Compute