Skip to main content
Glama
joehwang

Golden Egg TW Holdings MCP

by joehwang
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Golden Egg

Golden Egg 是台股券商庫存查詢命令列工具，可查詢並整合富邦、永豐、玉山、台新證券 Nova API 的持股資料。

image

重要前提

執行本專案前，必須先到各券商完成 API 申請流程。通常包含：

  • 申請或啟用證券 API 服務

  • 簽署 API 使用風險聲明書或同意書

  • 申請並下載交易憑證

  • 取得 API Key、API Secret、登入帳號密碼或券商設定檔

  • 等待券商完成開通；部分券商簽署後不是立即生效

沒有完成券商端 API 開通時，程式可以安裝，但無法成功登入券商 API。

Related MCP server: Yahoo Finance MCP Server

支援券商

券商

broker code

SDK

登入方式

富邦證券

fubon

fubon_neo 2.2.8

API Key + 憑證

永豐證券

sinopac

shioaji

API Key + API Secret + 憑證

玉山證券

esun

esun-trade

config.ini

台新證券 Nova API

tssco

taishin_sdk 1.0.2

帳密 + 憑證

各券商申請流程與設定欄位請看 券商設定文件。

環境需求

  • macOS ARM64

  • Python 3.13 或更高版本

  • uv

  • 各券商 API 權限與憑證

  • 本地 SDK wheel 檔案放在 wheels/

目前 *.whl 被 .gitignore 忽略。clone 專案後，請依 券商設定文件 下載需要的 SDK wheel 到 wheels/。

安裝 uv

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

安裝依賴

uv sync

可選：安裝成全域命令。

uv tool install --editable .

安裝後可直接使用：

golden-egg --help

確認台新 SDK 已安裝到目前 uv 環境：

uv run python -c "from taishin_sdk import TaishinSDK; print(TaishinSDK)"

設定檔模式

本專案透過根目錄 .env-debug 決定要讀正式設定還是測試設定。

EGG_DEBUG=true

讀取規則：

EGG_DEBUG

讀取檔案

true

broker/<broker>/.env.test

false

broker/<broker>/.env

如果你明明改了 .env 但程式沒有吃到，多半是因為 EGG_DEBUG=true，程式正在讀 .env.test。

基本使用

列出支援券商：

golden-egg brokers

查詢全部券商持股：

golden-egg holdings

查詢單一券商：

golden-egg holdings --broker fubon

查詢多個券商：

golden-egg holdings --broker fubon,esun

強制重新呼叫券商 API：

golden-egg holdings --broker tssco --force-refresh

輸出原始 JSON：

golden-egg holdings --broker fubon --raw

尚未安裝全域命令時，也可以用：

uv run python main.py holdings --broker all

測試

日常測試：

uv run pytest -q

單元測試：

uv run pytest -q test/unit

單一券商整合測試：

uv run pytest -W ignore::DeprecationWarning -v -s test/integration/test_fubon_integration.py
uv run pytest -W ignore::DeprecationWarning -v -s test/integration/test_tssco_integration.py
uv run pytest -W ignore::DeprecationWarning -v -s test/integration/test_sinopac_integration.py
uv run pytest -W ignore::DeprecationWarning -v -s test/integration/test_esun_integration.py

整合測試會連真實券商 API。若券商端暫時錯誤、rate limit 或尚未開通，測試可能 skip 或失敗。

文件

安全注意事項

  • 不要 commit .env 或 .env.test

  • 不要 commit .p12、.pfx、config.ini

  • 不要把 API key、API secret、憑證密碼貼到 issue 或 PR

  • wheels/*.whl 目前不進 git，請在本機自行準備

授權

MIT

This server cannot be installed

F
license - not found
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/joehwang/goldenegg-tw-holdings-cli'

If you have feedback or need assistance with the MCP directory API, please join our Discord server