Mopsfin 台湾株式 MCP Server

公開・読み取り専用・データベース不要の台湾企業財務データ MCP Server。サービスは Next.js 16 App Router と MCP TypeScript SDK v2 で実装され、Stateless Streamable HTTP /api/mcp を通じて7つのツールを公開。財務照会のたびに 公開資訊觀測站－財務比較 E 點通 へ直接アクセスします。

これは台湾証券取引所の公式 MCP Server ではなく、投資助言を構成するものでもありません。

アーキテクチャ

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

• データベース、Redis、または廃止された HTTP+SSE transport は使用しません。

• 財務データはキャッシュしません。ホームページから解析した動的カタログのみ、単一の Vercel instance メモリに5分間キャッシュします。

• 上流 URL は完全に固定され、ツールパラメータで URL を指定できないため、任意の proxy/SSRF にはなりません。

• 上流タイムアウトは20秒。ネットワークエラー、429、5xx は1回だけ再試行し、その他の 4xx は再試行しません。

• Mopsfin の cookie は保持・転送しません。

• レポートの latest は、直前の完了四半期から最大12四半期を遡ってプローブし、応答の期別を照合して、元サイトが静かに他の四半期にフォールバックするのを防ぎます。

• Vercel は Node.js 24.x、東京 hnd1、60秒の function duration と Fluid Compute を使用します。

Related MCP server: polygon-mcp

MCP ツール

各ツールは厳格な Zod input/output schema を持ち、短い content サマリーと完全な structuredContent を返します。ツール annotations は読み取り専用、非破壊、冪等、オープンワールド副作用なしとマークされています。

LLM は3層から解釈データを取得できます。MCP initialize の server instructions はデータ範囲全体と呼び出し順序を説明し、tools/list は7つのツールと各 input/output フィールドの用途と口径を提供し、list_catalog の officialGuidance と各 metric の guidance は計算式、数値ベース、適用業種、注意事項を提供します。実際の照会結果の warnings には、今回の照会に直接関連する申告頻度、単四半期／累計、欠損値、平均値、ページネーションの警告が含まれます。

コードが不明な場合は、最初に find_companies または list_catalog を呼び出します。list_catalog の family の対応は以下のとおりです：

トレンドはデフォルトで直近12四半期を返し、start_period、end_period、または history: "all" を使用できます。大きな HTML テーブルは offset、limit でページングし、デフォルト100行、上限500行です。期別の形式は YYYYQn です。

会社指標には include_industry_average、include_company_average で産業平均と選択会社の単純平均を追加できます。金融機関指標には include_industry_average、include_institution_average で対応する金融業種別平均と選択機関の単純平均を追加できます。これらの平均はすべて Mopsfin が計算したもので、時価総額加重ではありません。

データに関する質問に答える際は、少なくとも unit、実際の periods／period、照会 basis、warnings を保持してください。null、NO_DATA、または特定の四半期がないことは、該当しない、未申告、またはその市場ではそもそも申告不要である可能性を示し、0 に書き換えてはなりません。

ローカル開発

要件：Node.js 24、npm 11。

npm install
npm run dev

サービス：

• ホームページ：http://localhost:3000/

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

• ヘルスチェック：http://localhost:3000/api/health

ヘルスチェックは Mopsfin を呼び出さず、モニタリングトラフィックが元サイトへの固定クエリになるのを防ぎます。

公式 MCP Inspector または同梱の client で検証できます：

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

MCP client 設定例：

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

ChatGPT での使用

ChatGPT には接続可能な公開 HTTPS /api/mcp URL が必要です。ローカルの localhost はリモートの ChatGPT に直接渡すことはできません。

1. まず Vercel にデプロイし、https://<あなたのドメイン>/api/mcp を取得します。

2. ChatGPT で Settings → Security and login → Developer mode を開きます。

3. ChatGPT Plugins に移動し、プラスボタンを押して接続を追加します。

4. 名前（例：Mopsfin 台湾株式）を入力し、Connection URL を完全な https://<あなたのドメイン>/api/mcp に設定します。

5. 作成後、ChatGPT が7つのツールを認識できることを確認します。

6. 新しい会話を開始し、ツールメニューからこの MCP connection を追加して、自然言語で台湾株式について直接質問します。

Developer mode が利用できるかどうかは、アカウントのプランと workspace policy に依存します。詳細な手順は OpenAI 公式接続ガイド を参照してください。

質問例：

• 「TSMC の直近12四半期の営業収入を調べて、表にまとめて傾向を示してください。」

• 「TSMC と MediaTek の直近8四半期の ROE を比較してください。」

• 「TSMC の 2025Q4 貸借対照表の主要項目を一覧表示してください。」

• 「半導体業界の直近12四半期の売上高トレンドを比較してください。」

• 「台湾銀行の直近で利用可能な銀行業資本十分率を調べてください。」

検証

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

一般テストは固定 fixtures のみを使用し、53 の compareItem 分類、6 つの endpoint family、欠損値、負数、パーセンテージ、複数会社、HTML 結合セル、ページング、timeout、429、5xx、誤った四半期、MCP initialize/tools/list/tools/call をカバーします。

Live contract tests はデフォルトでスキップされ、明示的に設定した場合のみ元サイトに照会します：

npm run test:live

Mopsfin への固定トラフィックを避けるため、live tests を定期 CI に設定しないでください。

Vercel へのデプロイ

1. repository を Vercel にインポートします。

2. Build command は npm run build を使用します。Vercel は package-lock.json に基づいて npm インストールを実行します。

3. package.json は Node.js 24.x に固定されています。vercel.json は Fluid Compute を有効化しています。

4. デプロイ後、npm run test:client -- https://<preview>/api/mcp で受け入れテストを実行します。

5. 公開トラフィックに応じて Vercel Firewall に適切なルールを設定します。アプリ自体はクロスインスタンスの rate-limit データベースを構築しません。

Preview 受け入れテストの推奨：TSMC の直近12四半期の売上高、TSMC と MediaTek の ROE、指定四半期の貸借対照表、半導体産業トレンド、台湾銀行の資本十分率、TSMC の財務諸表注記。

エラーコード

• INVALID_ARGUMENT

• NOT_FOUND

• NO_DATA

• UPSTREAM_TIMEOUT

• UPSTREAM_RATE_LIMITED

• UPSTREAM_BAD_RESPONSE

市場別で申告四半期は異なります：上場／店頭公開企業は通常 Q1–Q4 ですが、興櫃および公募企業は Q2/Q4 のみの場合があり、一部の企業は年次のみ申告します。NO_DATA は必ずしも会社が存在しないことを意味しません。

データソース、更新、利用条件

データの唯一のソースは Mopsfin です。そのサイト利用規約によると、サイトデータは1日1回更新され、申告より約1日遅れる場合があります。本サービスはテスト fixtures を正式データやフォールバックとして使用しません。

公開稼働前に、プロジェクト所有者は TWSE/Mopsfin による公開プロキシ、再配布、利用頻度の許諾を自ら確認する必要があります。サイト利用規約のデータ範囲と更新頻度に関する記述は、再配布の明示的な許諾と同等ではありません。利用者は公開資訊觀測站の元の申告を最終確認として使用する必要があります。

主な参考資料

• OpenAI：Build an MCP server

• Vercel：MCP for Next.js

• Next.js 16 upgrade guide

• Vercel Node.js versions

• Vercel Fluid Compute