Finance Toolkit
500+ transparent financial methods calculated from raw statements, not third-party endpoints.
作者による説明(英語の原文)
Taiwan data for AI agents: THSR/TRA timetables, TWSE/TPEx stocks, invoice lottery, garbage, outages
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
使っているAIアプリを選んで、設定をコピーしてください。
TDX_CLIENT_ID, TDX_CLIENT_SECRET, X-TDX-Client-Id, X-TDX-Client-Secret「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。
必要なもの
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
このアドレスはリクエストの header にキーが必要ですが、コネクタを追加するメニューでは設定できません。代わりにClaude Code、Cursor、VS Codeを使ってください。
Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます
{
"mcpServers": {
"formosa": {
"command": "npx",
"args": [
"-y",
"formosa-mcp",
"--toolsets",
"invoice,stock,garbage,outage"
],
"env": {
"TDX_CLIENT_ID": "your-value",
"TDX_CLIENT_SECRET": "your-value"
}
}
}
}ターミナルでこれを実行します
claude mcp add --transport http formosa https://formosa-mcp.ycsmiley.workers.dev/mcp --header 'X-TDX-Client-Id: your-value' --header 'X-TDX-Client-Secret: your-value'claude mcp add formosa --env TDX_CLIENT_ID=your-value --env TDX_CLIENT_SECRET=your-value -- npx -y formosa-mcp --toolsets 'invoice,stock,garbage,outage'動かす前に、空欄の値を入力してください。
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"formosa": {
"url": "https://formosa-mcp.ycsmiley.workers.dev/mcp",
"headers": {
"X-TDX-Client-Id": "your-value",
"X-TDX-Client-Secret": "your-value"
}
}
}
}プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"formosa": {
"command": "npx",
"args": [
"-y",
"formosa-mcp",
"--toolsets",
"invoice,stock,garbage,outage"
],
"env": {
"TDX_CLIENT_ID": "your-value",
"TDX_CLIENT_SECRET": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"formosa": {
"type": "http",
"url": "https://formosa-mcp.ycsmiley.workers.dev/mcp",
"headers": {
"X-TDX-Client-Id": "your-value",
"X-TDX-Client-Secret": "your-value"
}
}
}
}プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"formosa": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"formosa-mcp",
"--toolsets",
"invoice,stock,garbage,outage"
],
"env": {
"TDX_CLIENT_ID": "your-value",
"TDX_CLIENT_SECRET": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
このアドレスはリクエストの header にキーが必要ですが、コネクタを追加するメニューでは設定できません。代わりにClaude Code、Cursor、VS Codeを使ってください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
TDX_CLIENT_ID envX-TDX-Client-Id HTTP headerX-TDX-Client-Secret 秘密 HTTP headerこの設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
ツールの名前と説明は、サーバーが2026年11月6日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。
invoice_get_winning_numbers查詢統一發票中獎號碼與領獎期間。Get Taiwan invoice winning numbers; omit period for the latest draw.
invoice_check統一發票對獎;未指定期別時檢查最新一期與仍可領獎的前一期。Check a Taiwan invoice number; 3–7 digits only check sixth prizes.
stock_quote以股票代號或名稱查詢上市/上櫃盤後行情、本益比與殖利率,非即時。Taiwan TWSE/TPEx end-of-day quote by code or name, not real-time.
stock_market_summary查詢上市加權指數、上櫃指數收盤漲跌、成交金額與融資券餘額(張)。兩市場各有資料日期,盤後資料,非即時;無需參數。Taiwan market closing summary, separately dated TWSE and TPEx; not real-time.
stock_dividends查詢上市/上櫃近期除權息日程,可指定股票代號或名稱。Upcoming Taiwan TWSE/TPEx ex-dividend and ex-right dates; optional code or name.
garbage_schedule查詢新北市、臺北市、臺中市垃圾車定點收運時刻。
outage_schedule查詢計畫性停水、停電公告;緊急搶修、事故、颱風造成的停水停電不會事先公告。Planned water/power outages only.
thsr_timetable查高鐵某日起迄站時刻;站名或代碼,日期預設臺北今天,時間 HH:mm;24:00–29:59 表示營運日隔日凌晨。THSR OD timetable; optional date and departure time.
tra_timetable查臺鐵某日起迄站時刻與車種;站名或代碼,日期預設臺北今天,時間 HH:mm;24:00–29:59 表示營運日隔日凌晨。TRA OD timetable with train types.
tra_live查臺鐵車次目前位置與誤點,或車站即時看板;train_no、station 恰填一項。TRA live train position/delay or station board; provide exactly one argument.
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント ycsmiley で確認済みです
このリポジトリはまだGitHubから読み取っていません
このリポジトリはまだGitHubから読み取っていません
684ミリ秒で応答(HTTP 200)
サインイン不要
10件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:TDX_CLIENT_SECRET, X-TDX-Client-Secret
どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。
GitHubリポジトリの最終更新は–、最新バージョン(0.2.0)がレジストリに届いたのは3 日前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URLでつながるので、リモートMCPサーバーに対応したアプリ(開発者モードのChatGPTなど)でも使えます。
同じカテゴリには:Finance Toolkit, SolidInvoice, Korea Tax Calculator
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
500+ transparent financial methods calculated from raw statements, not third-party endpoints.
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
Korean tax calculation and tax-audit judgment MCP: 96 tools with statutory citations.
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
繁體中文 · English
讓 Claude、Cursor 等 AI 助手查台灣統一發票對獎、台股(上市+上櫃)盤後行情與新北、臺北、臺中垃圾車時刻、計畫性停水停電,免金鑰;高鐵/台鐵遠端版提供今天與明天的時刻表。 Taiwan e-invoice lottery and TWSE/TPEx stock data for AI agents (MCP), no API key.
遠端免金鑰,可查發票、台股、垃圾車、停水停電、高鐵/台鐵今天與明天的時刻表,以及額度內的臺鐵即時資料。
遠端網址:https://formosa-mcp.ycsmiley.workers.dev/mcp
Claude(Desktop/網頁):在「設定 → 連接器 → 新增自訂連接器」貼上網址。
Claude Code:
claude mcp add --transport http formosa "https://formosa-mcp.ycsmiley.workers.dev/mcp"
Cursor(.cursor/mcp.json 或 ~/.cursor/mcp.json)與其他支援 streamable HTTP 的用戶端:
{
"mcpServers": { "formosa": { "url": "https://formosa-mcp.ycsmiley.workers.dev/mcp" } } }
需要 Node.js 20 以上。本機版預設啟用發票、台股、垃圾車、停水停電,直接向官方來源抓資料;鐵路需自備 TDX 金鑰,見鐵路金鑰。
在 Claude Desktop 的 claude_desktop_config.json 或 Cursor 的 .cursor/mcp.json(或 ~/.cursor/mcp.json)加入以下設定,然後重新啟動應用程式:
{
"mcpServers": { "formosa": { "command": "npx", "args": ["-y", "formosa-mcp"] } } }
Claude Code:
claude mcp add formosa -- npx -y formosa-mcp
Claude Code plugin:
claude plugin marketplace add ycsmiley/formosa-mcp
claude plugin install formosa@formosa-mcp
outage 工具集查台水、北水、台電計畫性公告,支援縣市、行政區、路名與最多 31 天的日期區間。工具:
| 工具 | 說明 | 本機 npm 版 | 遠端版 |
|---|---|---|---|
invoice_get_winning_numbers {period?} | 查最新或指定期別號碼、領獎期間;未公布期別顯示「尚未開獎」。 | ✅ | ✅ |
invoice_check {number, period?} | 接受 3–8 碼及兩碼英文字母前綴,3–7 碼只能判斷六獎;省略期別時檢查最新一期與仍可領獎的前一期。 | ✅ | ✅ |
stock_quote {query} | 以代號或名稱查上市/上櫃收盤、漲跌、成交量、本益比、殖利率與股價淨值比;名稱有多筆符合時列出代號供選擇。 | ✅ | ✅ |
stock_market_summary {} | 上市加權與上櫃指數收盤、漲跌、成交金額及融資券餘額(張);兩市場各自標示資料日期,非即時。 | ✅ | ✅ |
stock_dividends {query?} | 列出近期除權息,預設前 20 筆;可指定股票代號或名稱。 | ✅ | ✅ |
thsr_timetable {origin, destination, date?, time?} | 高鐵起迄站時刻。 | 需自備 TDX 金鑰+--toolsets rail | ✅ 今天與明天 |
tra_timetable {origin, destination, date?, time?} | 台鐵時刻、車種、停駛與加班車。 | 需自備 TDX 金鑰+--toolsets rail | ✅ 今天與明天 |
garbage_schedule {city, district?, keyword?, weekday?, time?} | 定點收運時刻。 | ✅ | ✅ |
outage_schedule {city, district?, keyword?, type?, start_date?, end_date?} | 計畫性停水停電,type 為 water、power 或 all(預設);省略日期時查臺北時間今天起七天,最多顯示 30 筆。 | ✅ | ✅ |
tra_live {train_no?, station?} | 恰填一項,查車次目前位置/誤點或車站即時看板。 | 需自備 TDX 金鑰+--toolsets rail | ✅ 額度內 |
行情資料日期遇假日可能落後;除權息以公司公告為準。
災害(disaster 工具集):實驗中,預設關閉,不保證資料完整。本機 npm 版在清單中加入 disaster 啟用,例如 --toolsets invoice,stock,garbage,outage,disaster(只寫 --toolsets disaster 則只開災害工具);遠端版/自架 Worker 需設定 DISASTER_ENABLED=true。詳見 docs/disaster.md。
需要 Node.js 20 以上。直接用 npm 套件:
npx -y formosa-mcp --toolsets=invoice,stock
MCP 客戶端設定:
{
"mcpServers": { "formosa": { "command": "npx", "args": ["-y", "formosa-mcp"] } } }
從原始碼執行:
git clone https://github.com/ycsmiley/formosa-mcp.git
cd formosa-mcp npm ci && npm run build node dist/stdio.js --toolsets=invoice,stock
從原始碼執行時的 mcpServers 設定,請將路徑換成實際絕對路徑:
{
"mcpServers": { "formosa": { "command": "node", "args": ["/absolute/path/formosa-mcp/dist/stdio.js", "--toolsets=invoice,stock"] } } }
已提交的 bundle 不需安裝 npm 套件即可執行:node plugin/server/formosa-mcp.mjs;Claude Code plugin 使用的也是這個 bundle。安裝 plugin:
claude plugin marketplace add ycsmiley/formosa-mcp
claude plugin install formosa@formosa-mcp
--toolsets=invoice,stock 啟用發票與台股,也可只選一組;預設啟用 invoice、stock、garbage、outage 四組,鐵路須明確啟用。--help 顯示用法。
資料來源與快取:
停水停電本機收集:npm run collect:outages -- --out /tmp/formosa-outages;設 FORMOSA_OUTAGE_DIR=/tmp/formosa-outages 供 stdio 讀取。未設時在 Node 程序抓取相關來源,成功快取 12 小時,失敗立即允許重試。collector bundle 以 npm run build:collectors 產生,plugin bundle 以 npm run build:plugin 更新後提交。
驗證:執行 npm run build、npm test、npm run live-check 及 npm run eval:live。後兩者需要網路;每日即時評估詳見 evals/README.md。
claude_desktop_config.json)或 Cursor(.cursor/mcp.json 或 ~/.cursor/mcp.json)的 MCP 設定加入 env,將下列佔位文字換成自己的金鑰:{
"mcpServers": { "formosa": { "command": "npx", "args": ["-y", "formosa-mcp", "--toolsets=invoice,stock,garbage,outage,rail"], "env": { "TDX_CLIENT_ID": "你的 Client Id", "TDX_CLIENT_SECRET": "你的 Client Secret" } } } }
金鑰只放在本機設定,不要貼到對話裡,也不要提交到版本控制;.env 已列入 gitignore。以 --toolsets=invoice,stock,garbage,outage,rail 或 --toolsets=rail 啟用;缺金鑰時,鐵路工具會顯示上述設定指引。
使用自己的金鑰在本機執行,可查即時車次與誤點。已於 2026-10-29 以真實 TDX 回應驗證。成功回覆標示資料介接「交通部TDX平臺」;詳見 TDX 鐵路測試資料。
發票、台股與專案模式的鐵路時刻表讀取 KV 快照;臺鐵即時查詢經單一 TDX 閘道按需取得,失敗時顯示表訂班次。個股證交所行情與發票由 Worker cron 更新;大盤摘要由既有 TPEx collector 抓取官方 FMTQIK、MI_MARGN、tpex_daily_trading_index、tpex_mainboard_margin_balance,寫入單一 stock:market:v1,遠端查詢只讀 KV。本機直接讀取相同 OpenAPI,快取一小時。上市可能較上櫃晚一天;各自顯示資料日期,不合併數值。融資券日期無法確認時,顯示上次確認日期的餘額,沒有舊資料則暫不提供。不新增排程;上櫃快照由 TPEx collector 寫入,鐵路快照由 GitHub Actions rail collector 寫入。垃圾車 collector 於臺北時間 11:37 更新三市。停水停電 collector 每天 06:23、12:23、18:23(臺北時間)抓取三個來源,以 outage:v1:{source}:{county}:{sha12}(SHA-256 前 12 碼)寫入依內容固定的縣市分片,KV TTL 為 8 天(目錄模式忽略 TTL);索引縣市條目記錄 writtenAt,相同內容僅在距上次寫入超過 3 天時續寫,失敗來源保留原縣市條目,最後每次寫入 outage:index:v1 索引心跳。Worker 從索引雜湊組出分片 key,僅讀 KV,不解析 ZIP/CSV,也不增加 Worker cron。Workers Free 維持每次 10 ms CPU,鐵路壓縮在 collector 執行。每 IP 每分鐘限制 30 次請求。
.mcp.json 或 Cursor 的 .cursor/mcp.json 遠端連線設定加入以下 headers(合併到既有端點設定):{
"mcpServers": { "formosa": { "headers": { "X-TDX-Client-Id": "YOUR_CLIENT_ID", "X-TDX-Client-Secret": "YOUR_CLIENT_SECRET" } } } }
自備金鑰可查其他日期與即時資料,不使用專案額度;每 IP 每分鐘 30 次的 MCP 限制仍適用。金鑰只用於該次請求,不儲存、不寫日誌;只放在用戶端私密設定,絕不可放進 URL、貼到對話或提交到版本控制。兩個 header 須一起提供,值去除前後空白後各為 1~256 個可列印 ASCII 字元。
完整專案功能須同時設定 repo secrets TDX_CLIENT_ID/TDX_CLIENT_SECRET(collector)與同名 Worker secrets(即時查詢);collector 另需 repo secret CLOUDFLARE_KV_WRITE_TOKEN 與 repo variable CLOUDFLARE_ACCOUNT_ID。缺 TDX repo secrets 時工作流程會成功略過。
鐵路本機 bootstrap 使用 node scripts/dist/publish-rail.mjs --out /tmp/rail --wrangler-bulk /tmp/rail-bulk.json,再匯入本機 KV;mock 設定與完整指令見下方文件。npm run build:collectors 重建兩個 collector bundle。
額度公式、監控、維護者 secrets 設定及離線壓力測試見遠端鐵路設計。
本機開發需 Node.js 22 以上;以下兩個 kv key put --local 指令將上櫃快照只寫入本機 KV,不會動到正式環境。
npm run dev:worker
npm run collect:tpex -- --out /tmp/tpex npx wrangler kv key put --binding SNAPSHOTS --local "stock:quotes:tpex:v1" --path /tmp/tpex/stock_quotes_tpex_v1.json npx wrangler kv key put --binding SNAPSHOTS --local "stock:dividends:tpex:v1" --path /tmp/tpex/stock_dividends_tpex_v1.json curl "http://localhost:8787/__scheduled" npm run remote-check
驗證可執行 npm run typecheck:worker、npm run test:worker。@modelcontextprotocol/sdk 為配合 agents 固定於精確版本 1.32.1。
請見 CONTRIBUTING.md 和 SECURITY.md。
MIT