Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

ai-twinkle/Hub

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

5 Commits

Repository files navigation

Twinkle Hub

Twinkle Hub

台灣第一個 MCP Hub — 串接 data.gov.tw 全量,讓 AI 直接查台灣資料

https://hub.twinkleai.tw

Discord Facebook LinkedIn Website


這是什麼

Twinkle Hub 是 MCP-as-a-Service — 一支 Bearer token 接進 Claude Desktop / Cursor / OpenClaw / Hermes Agent loop / 任何能講 MCP 的 AI client,然後 AI 就能查:

  • 📊 49,343 個台灣政府開放資料集(data.gov.tw 96.6% 全量,即時可查)
  • 🏛️ 13.5 萬筆政府採購 (PCC 政府電子採購網每日同步)
  • 🛠️ 32 個台灣專用 utility tool(身分證 / 統編 / 民國年 / 地址 / 機構查......)

alpha 期完全免費。試試:

「幫我規劃從臺北出發、3 天 2 夜的家庭親子行程,熱門景點 + 臺中合法民宿 + 沿路夜市」

「列出今年金額最大的政府採購 10 件、廠商分布」

「113 學年度大學招生錄取率最高的 10 個科系」


安裝(10 分鐘)

1. 取得 API key

https://hub.twinkleai.tw/login,用 Google 或 GitHub 一鍵登入。第一次登入會自動發給你一支 virtual API key (sk-...)。

2. Claude Desktop

編輯 config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

加入:

{
 "mcpServers": {
 "twinkle-hub": {
 "type": "http",
 "url": "https://api.twinkleai.tw/mcp/",
 "headers": {
 "Authorization": "Bearer sk-..."
 }
 }
 }
}

sk-... 換成你 dashboard 看到的 key,重啟 Claude Desktop,5 個 opendata-* tool + 32 個 twtools-* 就會出現。

3. Cursor

Cursor 用 ~/.cursor/mcp.json,格式跟 Claude Desktop 一樣。儲存後 → Settings → MCP → reload。

4. Claude Code (CLI)

claude mcp add --transport http twinkle-hub https://api.twinkleai.tw/mcp/ \
 --header "Authorization: Bearer sk-..."

5. OpenClaw / Hermes / 自己的 agent loop

我們是 MCP endpoint(開放協定,不是 SDK)。任何能講 MCP streamable-http 的 client / fastmcp Python loop / 你 fork 的 runtime 都能直接用。連 OAuth flow 都沒有,就一支可隨時 revoke 的 long-lived bearer。換個 endpoint 就走。

6. Codex app

編輯 config:

  • macOS / Linux: ~/.codex/config.toml
  • Windows: %USERPROFILE%\.codex\config.toml

加入:

[mcp_servers.twinkle-hub]
url = "https://api.twinkleai.tw/mcp/"
bearer_token_env_var = "TWINKLE_HUB_TOKEN"

再把你的 API key 設成環境變數。

macOS / Linux

export TWINKLE_HUB_TOKEN="sk-..."

Windows PowerShell

[Environment]::SetEnvironmentVariable(
 "TWINKLE_HUB_TOKEN",
 "sk-...",
 "User"
)

把 sk-... 換成你 dashboard 看到的 key,重啟 Codex,Twinkle Hub 的 tools 就會出現。

安裝完成後可用下面指令確認:

codex mcp get twinkle-hub

如果設定成功,至少會看到 5 個 opendata-* tools。

完整教學:https://hub.twinkleai.tw/docs


社群

想做什麼 去哪
聊天 / 問問題 / 想跟其他人討論 Discord — Twinkle AI
回 feature request / 報 bug Issues
看 alpha 期動態 / 新功能 ship Facebook 社團
關注公司 / 國際版 LinkedIn
官網 https://twinkleai.tw
支援 / 商業聯繫 support@twinkleai.tw

想要的功能 / 想接的資料?

請到 Issues 開單,我們有兩個模板:

  • 🎯 Feature request — 想要新功能、新 dataset、新 tool
  • 🐞 Bug report — 文件錯、tool 不能用、回應有問題

一般討論、想法腦力激盪、「這樣設計對不對」的問題,請去 Discord 不用開 issue。Discord 反應比較快。


License

這個 repo 是 community feedback hub,沒有 source code。Twinkle Hub 服務本身的條款看 /terms,資料授權看 /licenses

About

Twinkle Hub — community feedback / feature requests for hub.twinkleai.tw

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

AltStyle によって変換されたページ (->オリジナル) /