Skip to content
Back to search

TAOLibMCP

MCP server for taoyuan library

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/postoor--taolibmcp/badge.svg)](/listings/postoor--taolibmcp)

HTML

<a href="/listings/postoor--taolibmcp"><img src="/api/listings/postoor--taolibmcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

- 需求:Python 3.8+。 - 僅 `login()`(找書/書目/館藏):stdlib 即可。 - `login_web()`(讀者資料,MCP 預設):另需 `cryptography`、`Pillow`,以及系統 `tesseract`(任一 Latin 數字模型,如 `afr`/`eng`)。 - 憑證(擇一): - **單帳號**:專案根目錄 `.env` ``` USERNAME=你的借閱證號 PASSWORD=你的密碼 ``` 或環境變數 `TAOLIB_USERNAME` / `TAOLIB_PASSWORD` / `TAOLIB_ENV`。 - **多帳號**:`accounts.json`(見 `accounts.example.json`),第一個為預設; `name` 省略時以 `username` 當名稱: ```json { "accounts": [ { "name": "我", "username": "TY0000001", "password": "pw1" }, { "name": "家人", "username": "TY0000002", "password": "pw2" } ] } ``` 路徑預設 `./accounts.json`,可用 `TAOLIB_ACCOUNTS` 覆寫。每個帳號各自維持 獨立 session(獨立 cookie jar + 各自登入)。

在 Claude Code 使用(MCP)

專案已附 `.mcp.json`,在此目錄啟動 Claude Code 即會載入 `taolib` MCP server, 提供工具:`list_accounts`、`search_books`、`book_detail`、`book_holdings`、 `my_current_loans`、`my_borrow_history`、`my_reservations`、`my_cross_borrow`、 `list_sites`、`reader_info`、`place_hold`、`cancel_reservation`、`renew_books`。

**多帳號**:除 `list_accounts` 外,每個工具都接受可選的 `account` 參數(帳號 名稱或借閱證號);省略即用預設(第一個)帳號。先用 `list_accounts` 查有哪些。

手動加入其他 MCP client 的設定:

{
  "mcpServers": {
    "taolib": {
      "command": "python3",
      "args": ["-m", "taolib.mcp_server"],
      "cwd": "/home/lksdub/Workspace/TAOLib",
      "env": {
        "PYTHONPATH": "/home/lksdub/Workspace/TAOLib",
        "TAOLIB_ENV": "/home/lksdub/Workspace/TAOLib/.env"
      }
    }
  }
}

當成 Python library

# 單帳號
from taolib.client import client_from_env
c = client_from_env()
c.login_web()                 # 讀者資料需用 login_web(含驗證碼自解)
for b in c.search("貓", limit=5):
    print(b["sid"], b["title"], b["author"])
print(c.current_loans())            # 借閱中
print(c.reservations(arrived=True)) # 已到館可取
print(c.cross_borrow_list())        # 通閱

# 多帳號
from taolib.client import ClientManager
m = ClientManager()                 # 讀 accounts.json(或 .env fallback)
print(m.names())                    # ['我', '家人']
me   = m.get("我")                  # 各帳號獨立 session,首次呼叫才登入
fam  = m.get("家人")
print(len(me.current_loans()), len(fam.current_loans()))

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 164 lines
  1. # TAOLib — 桃園市立圖書館 API (reverse-engineered) + MCP server
  2. 反解官方 App **桃園市立圖書館** (`taoyuan.hylib.library2`, v1.1.25, Flutter) 後,
  3. 將其登入、找書、借閱中、預約、通閱等功能整理成一個 **MCP server**,讓 agent 直接呼叫。
  4. 後端為凌網科技 HyLib 系統:GraphQL endpoint
  5. `https://webpac.typl.gov.tw/api/HyLibWS/graphql`。
  6. ---
  7. ## 1. 逆向過程摘要
  8. | 項目 | 發現 |
  9. |------|------|
  10. | App 型態 | Flutter(業務邏輯在 Dart AOT `libapp.so`,Java 層僅殼) |
  11. | API | 單一 GraphQL endpoint `/api/HyLibWS/graphql`(HyLibWS) |
  12. | 主機架構 | `/` 是 Node.js(Next.js) 前端;`/api/HyLibWS/*` 是 Java/Tomcat 後端 |
  13. | GraphQL introspection | **已停用**(改用「錯誤訊息型別洩漏」反推 schema) |
  14. | 操作數 | 從 `libapp.so` 抽出 81 個 query/mutation |
  15. App 的 GraphQL query 字串直接嵌在 `libapp.so`;Web 版 (Next.js) 的 chunk 則提供
  16. 乾淨的 query/變數結構與加密金鑰,兩者交叉比對得到完整 API。
  17. ### 認證/請求模型(每個請求都需要)
  18. 1. `GET https://webpac.typl.gov.tw/` → 取得 `HYSESSION` cookie,並從頁面取出
  19. per-session 的 `csrfToken`(`"csrfToken":"..."`)。
  20. 2. 每個 GraphQL POST 都必須帶:
  21. - **Cookie**:`HYSESSION`(登入後再加 `JSESSIONID`)→ 用 cookie jar 維持
  22. - **Header**:`X-CSRF-Token: <csrfToken>`
  23. - 缺任一個 → 伺服器回 **HTTP 403**(Spring Security CSRF filter)
  24. 3. **兩種登入**(重點):
  25. - `appSSOLogin(user, pass)`(明文、免驗證碼)→ `{ appToken, readerCode }`。
  26. **但 appToken 只認證請求,不會把 reader 綁到 session** → 借閱中/預約/通閱/
  27. 歷史、`getReaderInfo` 全部回空/`null`。適合只做找書/書目/館藏的情境。
  28. - `ssoLogin(user, pass, captcha, encrypt:true)` → 真正把 reader 綁到 `HYSESSION`
  29. → 所有讀者資料可讀(cookie + `X-CSRF-Token`,不需 Bearer)。帳密需
  30. **AES-256-CBC** 加密,且要過**驗證碼**。
  31. 4. **驗證碼自解**(`login_web` 內建):`getCaptcha.message` 是 base64;decode 後對
  32. 固定金鑰做 cyclic-XOR 得到一張 PNG(末 18 bytes 是 `hyw<timestamp>eb` 的 session
  33. tag,非答案)。答案是畫在圖上的 5 位數字,用本機 `tesseract` 辨識(自動挑已安裝
  34. 的拉丁模型,優先 `eng` 再 `afr`;可用 `TAOLIB_TESS_LANG` 指定)。
  35. > `TaoLibClient` 兩種登入:`login()`(app token,輕量,僅非讀者資料)與
  36. > `login_web()`(reader-bound,讀者資料必用)。MCP server 預設走 `login_web()`。
  37. ### 關鍵 GraphQL 操作對照
  38. | 功能 | 操作 | 簽章(已驗證) |
  39. |------|------|------|
  40. | 登入 | `appSSOLogin` | `appSSOLogin(user,pass){appToken refreshToken readerCode success}` |
  41. | Token 更新 | `refreshAppToken` | `refreshAppToken(refreshToken){appToken refreshToken}` |
  42. | 找書 | `search` | `search(Input:{searchField:[String],searchInput:[String],op:[String],pageNo,limit})` |
  43. | 書目詳情 | `getBookDetail` | `getBookDetail(id:Int)` (id = search 結果的 `sid`) |
  44. | 館藏狀態 | `getHoldAllKeepSite` | `getHoldAllKeepSite(Input:{marcId,canShowHoldLendAndRead})` |
  45. | 借閱中 | `getLendFile` | `getLendFile(Input:{})` |
  46. | 借閱歷史 | `getHistory` | `getHistory(Input:{})` |
  47. | 預約(排隊/已到) | `getReadBook` | `getReadBook(Input:{showreadbook:"1"})` / `{showreadbookArrived:"1"}` |
  48. | 預約(依證號) | `getReadBookByReaderCode` | `getReadBookByReaderCode(Input:{readerCodeList:[String]})` |
  49. | 通閱(跨館) | `getTrAppMainProcess` | `getTrAppMainProcess(Input:{showreadbook:"1"})` |
  50. | 分館清單 | `getAllKeepSiteDataList` | `{keepsiteName keepSiteId keepsiteCode}` |
  51. | 預約下單 | `getHoldReserve` | `getHoldReserve(holdId,pickupKeepSiteId,readerValiddate)` |
  52. | 取消預約 | `doCancelReserve` | `doCancelReserve(id:Int)` |
  53. | 續借 | `batchContuineBook` | `batchContuineBook(ids:[Int])` |
  54. 所有清單型 resolver 回傳通用 `LayoutReturnResult`:
  55. `{ list { values [ { ref [ { key, value } ] } ] } }`,每列是一組 key/value,
  56. `client._rows()` 會攤平成 `dict`。找書每列含 `sid`(記錄id)、`title`、`author`、
  57. `isbn`、`publisher`、`pubyear`、`isCanLend` 等。
  58. ---
  59. ## 2. 安裝 / 設定
  60. - 需求:Python 3.8+。
  61. - 僅 `login()`(找書/書目/館藏):stdlib 即可。
  62. - `login_web()`(讀者資料,MCP 預設):另需 `cryptography`、`Pillow`,以及系統
  63. `tesseract`(任一 Latin 數字模型,如 `afr`/`eng`)。
  64. - 憑證(擇一):
  65. - **單帳號**:專案根目錄 `.env`
  66. ```
  67. USERNAME=你的借閱證號
  68. PASSWORD=你的密碼
  69. ```
  70. 或環境變數 `TAOLIB_USERNAME` / `TAOLIB_PASSWORD` / `TAOLIB_ENV`。
  71. - **多帳號**:`accounts.json`(見 `accounts.example.json`),第一個為預設;
  72. `name` 省略時以 `username` 當名稱:
  73. ```json
  74. { "accounts": [
  75. { "name": "我", "username": "TY0000001", "password": "pw1" },
  76. { "name": "家人", "username": "TY0000002", "password": "pw2" }
  77. ] }
  78. ```
  79. 路徑預設 `./accounts.json`,可用 `TAOLIB_ACCOUNTS` 覆寫。每個帳號各自維持
  80. 獨立 session(獨立 cookie jar + 各自登入)。
  81. ### 在 Claude Code 使用(MCP)
  82. 專案已附 `.mcp.json`,在此目錄啟動 Claude Code 即會載入 `taolib` MCP server,
  83. 提供工具:`list_accounts`、`search_books`、`book_detail`、`book_holdings`、
  84. `my_current_loans`、`my_borrow_history`、`my_reservations`、`my_cross_borrow`、
  85. `list_sites`、`reader_info`、`place_hold`、`cancel_reservation`、`renew_books`。
  86. **多帳號**:除 `list_accounts` 外,每個工具都接受可選的 `account` 參數(帳號
  87. 名稱或借閱證號);省略即用預設(第一個)帳號。先用 `list_accounts` 查有哪些。
  88. 手動加入其他 MCP client 的設定:
  89. ```json
  90. {
  91. "mcpServers": {
  92. "taolib": {
  93. "command": "python3",
  94. "args": ["-m", "taolib.mcp_server"],
  95. "cwd": "/home/lksdub/Workspace/TAOLib",
  96. "env": {
  97. "PYTHONPATH": "/home/lksdub/Workspace/TAOLib",
  98. "TAOLIB_ENV": "/home/lksdub/Workspace/TAOLib/.env"
  99. }
  100. }
  101. }
  102. }
  103. ```
  104. ### 當成 Python library
  105. ```python
  106. # 單帳號
  107. from taolib.client import client_from_env
  108. c = client_from_env()
  109. c.login_web() # 讀者資料需用 login_web(含驗證碼自解)
  110. for b in c.search("貓", limit=5):
  111. print(b["sid"], b["title"], b["author"])
  112. print(c.current_loans()) # 借閱中
  113. print(c.reservations(arrived=True)) # 已到館可取
  114. print(c.cross_borrow_list()) # 通閱
  115. # 多帳號
  116. from taolib.client import ClientManager
  117. m = ClientManager() # 讀 accounts.json(或 .env fallback)
  118. print(m.names()) # ['我', '家人']
  119. me = m.get("我") # 各帳號獨立 session,首次呼叫才登入
  120. fam = m.get("家人")
  121. print(len(me.current_loans()), len(fam.current_loans()))
  122. ```
  123. ---
  124. ## 3. 寫入動作(會更動真實帳號)
  125. `place_hold` / `cancel_reservation` / `renew_books` 會真的預約/取消/續借。
  126. query 結構已從 App 還原,但**未在測試帳號上實際觸發**(避免外部副作用);
  127. 使用前請確認讀者意圖。
  128. ---
  129. ## 4. 已驗證範圍
  130. 以 `.env` 測試帳號 `login_web()` 實測(HTTP 200、真實資料):
  131. - 登入(ssoLogin + 自解驗證碼)、`reader_info`(讀者姓名)
  132. - 找書(真實書目)、書目詳情(37 欄)、館藏狀態、分館清單(43)
  133. - **借閱中 30 筆**(含 title/returndate/lenddate/barcode/len_id/續借資訊)、
  134. **借閱歷史 30 筆**、預約(排隊/已到,當前 0)、通閱(當前 0)
  135. - MCP server:initialize / tools/list / tools/call(`my_current_loans` 回 30)
  136. 未實際觸發的只有寫入動作(見下節)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.