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
이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.
이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.
쓰고 있는 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를 쓰세요.
선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.
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에서 이 저장소를 읽어 오지 않았어요
684ms 만에 응답(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 스타i세 기둥: 리뷰 · 점검 · 사용 정도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