Skip to content

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