mcp104 0.1.0__tar.gz

mcp104-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jason Chueh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcp104-0.1.0/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.4
+Name: mcp104
+Version: 0.1.0
+Summary: MCP server that lets an AI agent operate a 104人力銀行 enterprise recruiting account — résumé search, job listings, messaging and 詢問意願 events, with a device-flow login that keeps credentials out of the LLM
+Author-email: Jason Chueh <jasoncychueh@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Jason Chueh
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/jasoncychueh/104mcp
+Project-URL: Repository, https://github.com/jasoncychueh/104mcp.git
+Project-URL: Issues, https://github.com/jasoncychueh/104mcp/issues
+Keywords: 104,mcp,model-context-protocol,recruiting,playwright,claude
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp[cli]<2,>=1.12
+Requires-Dist: patchright>=1.0.0
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: tzdata>=2024.1
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"
+Requires-Dist: ruff>=0.14; extra == "dev"
+Requires-Dist: pyflakes>=3.2; extra == "dev"
+Dynamic: license-file
+
+# 104-mcp
+
+[![PyPI](https://img.shields.io/pypi/v/mcp104)](https://pypi.org/project/mcp104/)
+[![Python](https://img.shields.io/pypi/pyversions/mcp104)](https://pypi.org/project/mcp104/)
+[![License: MIT](https://img.shields.io/github/license/jasoncychueh/104mcp)](LICENSE)
+[![GitHub](https://img.shields.io/github/stars/jasoncychueh/104mcp?style=social)](https://github.com/jasoncychueh/104mcp)
+
+讓 AI Agent（Claude Code 或任何 MCP client）操作 **104 人力銀行企業徵才帳號**
+的 MCP server：搜尋履歷、列出職缺、讀取與發送站內信、送出「詢問意願」邀約、
+記錄候選人聯繫狀態。
+
+帳號密碼**不會經過 AI 的對話內容**。登入時 Agent 只拿到一個網址，由你本人在
+一個只綁定本機（`127.0.0.1`）的頁面裡完成登入，包含 104 每次都會要求的手機
+驗證碼（MFA）。登入之外的所有操作都直接呼叫 104 的 JSON API，不需要開瀏覽器。
+
+---
+
+## 安裝
+
+只要三步，照著做即可。以 Claude Code 為例，其他 MCP client 的設定檔格式不同，
+但欄位相同。
+
+1. 安裝 [uv](https://docs.astral.sh/uv/)。
+
+   Windows（PowerShell）：
+
+   ```powershell
+   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+   ```
+
+   macOS／Linux：
+
+   ```bash
+   curl -LsSf https://astral.sh/uv/install.sh | sh
+   ```
+
+2. 在專案根目錄的 `.mcp.json` 加入：
+
+   ```json
+   {
+     "mcpServers": {
+       "104-mcp": {
+         "command": "uvx",
+         "args": ["--from", "git+https://github.com/jasoncychueh/104mcp.git", "mcp104"],
+         "env": {
+           "MCP104_ACCOUNT": "<你的 104 帳號識別，例如公司信箱或帳號名>"
+         },
+         "timeout": 120000
+       }
+     }
+   }
+   ```
+
+   `MCP104_ACCOUNT` 是必填的，用來分開不同 104 帳號各自的資料（候選人狀態、
+   每日發送計數）。`timeout` 是單一工具呼叫的上限（毫秒），120 秒是本專案建議
+   的值，請照抄。
+
+   套件發布到 PyPI 之後，`args` 可以簡化成 `["mcp104"]`。
+
+3. 啟動 Claude Code，請 Agent 呼叫 `login()`，在跳出的瀏覽器視窗完成 104 登入。
+   第一次登入會自動下載一份專用的 Chromium（約 300 MB），不需要自己安裝任何東西。
+
+### 常見狀況
+
+- **第一次連線逾時**：Claude Code 給 MCP server 30 秒啟動時間，`uvx` 第一次要
+  下載並建置套件，可能超過 30 秒。用 `/mcp` 重新連線一次即可，之後約 1 秒就能啟動。
+- **更新到新版**：`uvx` 會用快取，不會自動抓新版。跑一次
+  `uvx --refresh --from git+https://github.com/jasoncychueh/104mcp.git mcp104`（PyPI 版是 `uvx --refresh mcp104`）。
+- **換帳號**：`MCP104_ACCOUNT` 綁定在資料目錄上，同一個目錄只能有一個值。要用第二個
+  104 帳號，請另外設 `MCP104_DATA_DIR` 指向一個新目錄。
+
+---
+
+## 登入流程
+
+104 的登入每次都會觸發手機驗證碼（因為每次都是全新的瀏覽器），所以沒有辦法
+自動登入，一定要你本人操作一次。流程如下：
+
+1. Agent 呼叫 `login()`。伺服器會用你的預設瀏覽器打開登入頁（同一台機器時），
+   Agent 也會告訴你網址。
+2. 你在那個頁面裡輸入帳密、手機驗證碼。畫面是即時串流的 104 登入頁，滑鼠鍵盤
+   都照常用。
+3. 有兩個地方需要你手動點一下，Agent 看不出差別：
+   - **產品選擇頁**：帳號底下有多個 104 產品時，請點「招募管理」。
+   - **「此帳號已登入」對話框**：同一帳號已在別處登入時，請選「將目前帳號登出，
+     立即登入」。
+4. 登入完成後頁面會顯示「登入已完成」並嘗試自動關閉（瀏覽器不允許的話請自行關掉）。
+   Agent 會自己等到這一刻，不需要你回頭告訴它「登入了」。
+
+完整走完一次（含驗證碼與上面兩個分支）實測約 4–5 分鐘。登入憑證會存在本機資料
+目錄，之後重開 Claude Code 不需要再登入，直到 104 那邊的登入過期為止。
+
+---
+
+## 工具一覽
+
+完整參數與回傳格式請看各工具自己的說明；這裡只列一句話用途。
+
+**登入**
+- `login()` — 開始一次登入，或在憑證仍有效時直接回報已登入
+- `check_login(token, wait_seconds)` — 等待一次登入完成（Agent 用，一般不需自己呼叫）
+- `logout()` — 清除本機登入憑證
+
+**履歷與職缺**
+- `search_resumes(keyword, filters, page)` — 依關鍵字與篩選條件搜尋履歷
+- `list_recommended_resumes(jobno, page)` — 列出 104 推薦給某職缺的履歷
+- `list_matched_resumes(jobno, page, update_date_type)` — 列出配對到某職缺的履歷；`update_date_type="2"` 只看當日配對
+- `get_resume_detail(candidate_id)` — 取得單一候選人的完整履歷
+- `list_jobs(page)` — 列出這個帳號底下的職缺
+
+**篩選與欄位說明（純本機資料，不呼叫 104）**
+- `browse_filter_values(key, code)` — 查 `search_resumes` 某個篩選鍵接受哪些值
+- `describe_result_fields(row_type)` — 說明各工具回傳的每個欄位是什麼意思
+
+**訊息**
+- `read_messages(page, job_nos, candidate_name)` — 讀取收件匣
+- `get_conversation(job_id, candidate_id, page)` — 讀取一段對話
+- `send_message(job_id, candidate_id, message)` — 發送一則純文字站內信
+- `send_inquiry(job_id, candidate_id, message, template_id)` — 送出「詢問意願」邀約
+- `list_templates(type_id, page)` — 列出帳號裡存好的罐頭信範本
+
+**候選人狀態（存在本機，與 104 無關）**
+- `check_already_contacted(candidate_id, id_source)` — 查是否已聯繫過
+- `update_candidate_status(candidate_id, id_source, status)` — 更新狀態標記
+
+---
+
+## 環境變數
+
+| 變數 | 必填／預設 | 說明 |
+|---|---|---|
+| `MCP104_ACCOUNT` | **必填** | 識別這次執行對應哪一個 104 帳號。不要填主機名或作業系統帳號 |
+| `MCP104_DATA_DIR` | 選填，預設依平台慣例放在使用者目錄下 | 資料庫、登入憑證、節流狀態都存在這裡 |
+| `MCP104_AUTH_BASE_URL` | 選填，須與 `MCP104_AUTH_BIND_PORT` 成對設定 | 登入頁的對外網址，你和伺服器不在同一台機器時才需要 |
+| `MCP104_AUTH_BIND_PORT` | 選填，須與 `MCP104_AUTH_BASE_URL` 成對設定 | 登入頁監聽的埠 |
+| `MAX_DAILY_MESSAGES` | `50` | 每個帳號每天最多發幾則訊息（`send_message` 與 `send_inquiry` 合計） |
+| `LOGIN_TIMEOUT_SECONDS` | `900` | 等你完成登入的上限秒數 |
+| `MAX_REQUESTS_PER_HOUR` | `300` | 每小時對 104 的請求上限 |
+| `MAX_INLINE_WAIT_SECONDS` | `20` | 節流等待超過這個秒數就改回覆「稍後再試」 |
+| `ACTIVITY_STREAK_LIMIT_MINUTES` | `20` | 連續操作多久後強制休息 |
+| `REST_DURATION_MINUTES` | `3` | 強制休息的長度 |
+| `MIN_CALL_INTERVAL_SECONDS` | `5` | 兩次呼叫之間的最小間隔 |
+
+---
+
+## 安全與節流
+
+- **每一次發送都會真的送到一位求職者手上**，無法撤回、沒有試發模式。請要求 Agent
+  先把收件人與完整內文給你看過再發。
+- **每日發送上限 50 則**，`send_message` 與 `send_inquiry` 共用計數。
+- **請求節流**：兩次呼叫至少間隔 5 秒、每小時最多 300 次、連續操作 20 分鐘後休息
+  3 分鐘，模擬真人節奏，降低被 104 判定為機器人的風險。
+- **104 自己的履歷瀏覽上限**：每天 300 份，由 104 執行；接近上限時工具會提醒。
+- **遇到 Cloudflare 機器人驗證**：工具會回傳明確錯誤並要求暫停至少 1 小時。這不是
+  「查無資料」，換關鍵字重試只會讓封鎖更嚴重。
+- **不送已讀回報**：Agent 讀訊息不會讓對方看到「已讀」，這是刻意的。
+- **登入憑證存在本機資料目錄**，請不要把那個目錄下的檔案交給任何人或提交進版本控制。
+
+---
+
+## 免責聲明
+
+這是非官方專案，與 104 人力銀行沒有任何關係，未經其授權或背書。請只在你有權操作的
+帳號上使用，並遵守 104 的服務條款；透過本工具送出的每一則訊息、每一次邀約，後果由
+操作者自行負責。
+
+回報問題請到 [GitHub Issues](https://github.com/jasoncychueh/104mcp/issues)。
+
+## 授權
+
+MIT，見 [LICENSE](LICENSE)。

mcp104-0.1.0/README.md

@@ -0,0 +1,171 @@
+# 104-mcp
+
+[![PyPI](https://img.shields.io/pypi/v/mcp104)](https://pypi.org/project/mcp104/)
+[![Python](https://img.shields.io/pypi/pyversions/mcp104)](https://pypi.org/project/mcp104/)
+[![License: MIT](https://img.shields.io/github/license/jasoncychueh/104mcp)](LICENSE)
+[![GitHub](https://img.shields.io/github/stars/jasoncychueh/104mcp?style=social)](https://github.com/jasoncychueh/104mcp)
+
+讓 AI Agent（Claude Code 或任何 MCP client）操作 **104 人力銀行企業徵才帳號**
+的 MCP server：搜尋履歷、列出職缺、讀取與發送站內信、送出「詢問意願」邀約、
+記錄候選人聯繫狀態。
+
+帳號密碼**不會經過 AI 的對話內容**。登入時 Agent 只拿到一個網址，由你本人在
+一個只綁定本機（`127.0.0.1`）的頁面裡完成登入，包含 104 每次都會要求的手機
+驗證碼（MFA）。登入之外的所有操作都直接呼叫 104 的 JSON API，不需要開瀏覽器。
+
+---
+
+## 安裝
+
+只要三步，照著做即可。以 Claude Code 為例，其他 MCP client 的設定檔格式不同，
+但欄位相同。
+
+1. 安裝 [uv](https://docs.astral.sh/uv/)。
+
+   Windows（PowerShell）：
+
+   ```powershell
+   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+   ```
+
+   macOS／Linux：
+
+   ```bash
+   curl -LsSf https://astral.sh/uv/install.sh | sh
+   ```
+
+2. 在專案根目錄的 `.mcp.json` 加入：
+
+   ```json
+   {
+     "mcpServers": {
+       "104-mcp": {
+         "command": "uvx",
+         "args": ["--from", "git+https://github.com/jasoncychueh/104mcp.git", "mcp104"],
+         "env": {
+           "MCP104_ACCOUNT": "<你的 104 帳號識別，例如公司信箱或帳號名>"
+         },
+         "timeout": 120000
+       }
+     }
+   }
+   ```
+
+   `MCP104_ACCOUNT` 是必填的，用來分開不同 104 帳號各自的資料（候選人狀態、
+   每日發送計數）。`timeout` 是單一工具呼叫的上限（毫秒），120 秒是本專案建議
+   的值，請照抄。
+
+   套件發布到 PyPI 之後，`args` 可以簡化成 `["mcp104"]`。
+
+3. 啟動 Claude Code，請 Agent 呼叫 `login()`，在跳出的瀏覽器視窗完成 104 登入。
+   第一次登入會自動下載一份專用的 Chromium（約 300 MB），不需要自己安裝任何東西。
+
+### 常見狀況
+
+- **第一次連線逾時**：Claude Code 給 MCP server 30 秒啟動時間，`uvx` 第一次要
+  下載並建置套件，可能超過 30 秒。用 `/mcp` 重新連線一次即可，之後約 1 秒就能啟動。
+- **更新到新版**：`uvx` 會用快取，不會自動抓新版。跑一次
+  `uvx --refresh --from git+https://github.com/jasoncychueh/104mcp.git mcp104`（PyPI 版是 `uvx --refresh mcp104`）。
+- **換帳號**：`MCP104_ACCOUNT` 綁定在資料目錄上，同一個目錄只能有一個值。要用第二個
+  104 帳號，請另外設 `MCP104_DATA_DIR` 指向一個新目錄。
+
+---
+
+## 登入流程
+
+104 的登入每次都會觸發手機驗證碼（因為每次都是全新的瀏覽器），所以沒有辦法
+自動登入，一定要你本人操作一次。流程如下：
+
+1. Agent 呼叫 `login()`。伺服器會用你的預設瀏覽器打開登入頁（同一台機器時），
+   Agent 也會告訴你網址。
+2. 你在那個頁面裡輸入帳密、手機驗證碼。畫面是即時串流的 104 登入頁，滑鼠鍵盤
+   都照常用。
+3. 有兩個地方需要你手動點一下，Agent 看不出差別：
+   - **產品選擇頁**：帳號底下有多個 104 產品時，請點「招募管理」。
+   - **「此帳號已登入」對話框**：同一帳號已在別處登入時，請選「將目前帳號登出，
+     立即登入」。
+4. 登入完成後頁面會顯示「登入已完成」並嘗試自動關閉（瀏覽器不允許的話請自行關掉）。
+   Agent 會自己等到這一刻，不需要你回頭告訴它「登入了」。
+
+完整走完一次（含驗證碼與上面兩個分支）實測約 4–5 分鐘。登入憑證會存在本機資料
+目錄，之後重開 Claude Code 不需要再登入，直到 104 那邊的登入過期為止。
+
+---
+
+## 工具一覽
+
+完整參數與回傳格式請看各工具自己的說明；這裡只列一句話用途。
+
+**登入**
+- `login()` — 開始一次登入，或在憑證仍有效時直接回報已登入
+- `check_login(token, wait_seconds)` — 等待一次登入完成（Agent 用，一般不需自己呼叫）
+- `logout()` — 清除本機登入憑證
+
+**履歷與職缺**
+- `search_resumes(keyword, filters, page)` — 依關鍵字與篩選條件搜尋履歷
+- `list_recommended_resumes(jobno, page)` — 列出 104 推薦給某職缺的履歷
+- `list_matched_resumes(jobno, page, update_date_type)` — 列出配對到某職缺的履歷；`update_date_type="2"` 只看當日配對
+- `get_resume_detail(candidate_id)` — 取得單一候選人的完整履歷
+- `list_jobs(page)` — 列出這個帳號底下的職缺
+
+**篩選與欄位說明（純本機資料，不呼叫 104）**
+- `browse_filter_values(key, code)` — 查 `search_resumes` 某個篩選鍵接受哪些值
+- `describe_result_fields(row_type)` — 說明各工具回傳的每個欄位是什麼意思
+
+**訊息**
+- `read_messages(page, job_nos, candidate_name)` — 讀取收件匣
+- `get_conversation(job_id, candidate_id, page)` — 讀取一段對話
+- `send_message(job_id, candidate_id, message)` — 發送一則純文字站內信
+- `send_inquiry(job_id, candidate_id, message, template_id)` — 送出「詢問意願」邀約
+- `list_templates(type_id, page)` — 列出帳號裡存好的罐頭信範本
+
+**候選人狀態（存在本機，與 104 無關）**
+- `check_already_contacted(candidate_id, id_source)` — 查是否已聯繫過
+- `update_candidate_status(candidate_id, id_source, status)` — 更新狀態標記
+
+---
+
+## 環境變數
+
+| 變數 | 必填／預設 | 說明 |
+|---|---|---|
+| `MCP104_ACCOUNT` | **必填** | 識別這次執行對應哪一個 104 帳號。不要填主機名或作業系統帳號 |
+| `MCP104_DATA_DIR` | 選填，預設依平台慣例放在使用者目錄下 | 資料庫、登入憑證、節流狀態都存在這裡 |
+| `MCP104_AUTH_BASE_URL` | 選填，須與 `MCP104_AUTH_BIND_PORT` 成對設定 | 登入頁的對外網址，你和伺服器不在同一台機器時才需要 |
+| `MCP104_AUTH_BIND_PORT` | 選填，須與 `MCP104_AUTH_BASE_URL` 成對設定 | 登入頁監聽的埠 |
+| `MAX_DAILY_MESSAGES` | `50` | 每個帳號每天最多發幾則訊息（`send_message` 與 `send_inquiry` 合計） |
+| `LOGIN_TIMEOUT_SECONDS` | `900` | 等你完成登入的上限秒數 |
+| `MAX_REQUESTS_PER_HOUR` | `300` | 每小時對 104 的請求上限 |
+| `MAX_INLINE_WAIT_SECONDS` | `20` | 節流等待超過這個秒數就改回覆「稍後再試」 |
+| `ACTIVITY_STREAK_LIMIT_MINUTES` | `20` | 連續操作多久後強制休息 |
+| `REST_DURATION_MINUTES` | `3` | 強制休息的長度 |
+| `MIN_CALL_INTERVAL_SECONDS` | `5` | 兩次呼叫之間的最小間隔 |
+
+---
+
+## 安全與節流
+
+- **每一次發送都會真的送到一位求職者手上**，無法撤回、沒有試發模式。請要求 Agent
+  先把收件人與完整內文給你看過再發。
+- **每日發送上限 50 則**，`send_message` 與 `send_inquiry` 共用計數。
+- **請求節流**：兩次呼叫至少間隔 5 秒、每小時最多 300 次、連續操作 20 分鐘後休息
+  3 分鐘，模擬真人節奏，降低被 104 判定為機器人的風險。
+- **104 自己的履歷瀏覽上限**：每天 300 份，由 104 執行；接近上限時工具會提醒。
+- **遇到 Cloudflare 機器人驗證**：工具會回傳明確錯誤並要求暫停至少 1 小時。這不是
+  「查無資料」，換關鍵字重試只會讓封鎖更嚴重。
+- **不送已讀回報**：Agent 讀訊息不會讓對方看到「已讀」，這是刻意的。
+- **登入憑證存在本機資料目錄**，請不要把那個目錄下的檔案交給任何人或提交進版本控制。
+
+---
+
+## 免責聲明
+
+這是非官方專案，與 104 人力銀行沒有任何關係，未經其授權或背書。請只在你有權操作的
+帳號上使用，並遵守 104 的服務條款；透過本工具送出的每一則訊息、每一次邀約，後果由
+操作者自行負責。
+
+回報問題請到 [GitHub Issues](https://github.com/jasoncychueh/104mcp/issues)。
+
+## 授權
+
+MIT，見 [LICENSE](LICENSE)。

mcp104-0.1.0/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = ["setuptools>=68"]          # no upper bound: a bad backend fails the build loudly
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mcp104"
+version = "0.1.0"
+description = "MCP server that lets an AI agent operate a 104人力銀行 enterprise recruiting account — résumé search, job listings, messaging and 詢問意願 events, with a device-flow login that keeps credentials out of the LLM"
+readme = "README.md"
+license = {file = "LICENSE"}           # PEP 639 string form (`license = "MIT"`) needs
+                                        # setuptools>=69.3 for SPDX-expression support;
+                                        # build-system below pins setuptools>=68 with no
+                                        # upper bound, so an older resolved setuptools could
+                                        # fail on the string form. The file form is valid
+                                        # under both old (PEP 621 table) and current
+                                        # setuptools, so it's the safe choice here.
+authors = [{name = "Jason Chueh", email = "jasoncychueh@gmail.com"}]
+keywords = ["104", "mcp", "model-context-protocol", "recruiting", "playwright", "claude"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Operating System :: OS Independent",
+  "Topic :: Software Development :: Libraries",
+]
+requires-python = ">=3.10"             # Floor is undecided, not measured against any
+                                        # runtime this project still targets: the container
+                                        # that used to explain this value (Python 3.10.12 on
+                                        # mcr.microsoft.com/playwright/python:v1.44.0-jammy)
+                                        # is gone (stdio rearchitecture); the dev machine
+                                        # measures 3.13.5. Whether to support 3.10 is a
+                                        # separate, undecided call — see backlog e5b3a2 — this
+                                        # value is carried forward unchanged, not re-validated.
+dependencies = [
+  "mcp[cli]>=1.12,<2",                 # <2 is load-bearing: 2.0 moves mcp.server.fastmcp
+  "patchright>=1.0.0",                 #   and renames FastMCP; unpinned fails at import
+  "aiosqlite>=0.20.0",
+  "aiohttp>=3.9.0",
+  "tzdata>=2024.1",
+]
+
+[project.optional-dependencies]
+# The ruff / pyflakes floors below are conservative floors BELOW the versions actually
+# measured on the dev machine (ruff 0.14.7, pyflakes 3.2.0) — not tested minima. Say so
+# here rather than implying either was measured as a working lower bound.
+dev = ["pytest>=8.0.0", "pytest-asyncio>=0.24.0", "ruff>=0.14", "pyflakes>=3.2"]
+
+[project.urls]
+Homepage = "https://github.com/jasoncychueh/104mcp"
+Repository = "https://github.com/jasoncychueh/104mcp.git"
+Issues = "https://github.com/jasoncychueh/104mcp/issues"
+
+[project.scripts]
+mcp104 = "mcp104.main:run"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+mcp104 = ["assets/**/*.json", "assets/**/*.md"]   # .md required: both READMEs are cited
+                                                   # from module docstrings
+
+[tool.ruff]
+target-version = "py310"

mcp104-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mcp104-0.1.0/src/mcp104/assets/104-categories/Abroad.json

@@ -0,0 +1 @@
+[{"no":"7001000000","des":"亞洲","n":[{"no":"7001053000","des":"台灣","eng":"Taiwan"},{"no":"7001001000","des":"中國","eng":"China"},{"no":"7001002000","des":"香港/澳門特別行政區","eng":"Hong Kong/Macau SAR"},{"no":"7001003000","des":"日本","eng":"Japan"},{"no":"7001004000","des":"北韓","eng":"North Korea"},{"no":"7001005000","des":"南韓","eng":"South Korea"},{"no":"7001006000","des":"越南","eng":"Vietnam"},{"no":"7001007000","des":"寮國","eng":"Laos"},{"no":"7001008000","des":"柬埔寨","eng":"Cambodia"},{"no":"7001009000","des":"緬甸","eng":"Myanmar"},{"no":"7001010000","des":"泰國","eng":"Thailand"},{"no":"7001011000","des":"馬來西亞","eng":"Malaysia"},{"no":"7001012000","des":"新加坡","eng":"Singapore"},{"no":"7001013000","des":"菲律賓","eng":"Philippines"},{"no":"7001014000","des":"汶萊","eng":"Brunei"},{"no":"7001015000","des":"印尼","eng":"Indonesia"},{"no":"7001016000","des":"阿富汗","eng":"Afghanistan"},{"no":"7001017000","des":"巴林","eng":"Bahrain"},{"no":"7001018000","des":"伊朗","eng":"Iran"},{"no":"7001019000","des":"伊拉克","eng":"Iraq"},{"no":"7001020000","des":"以色列","eng":"Israel"},{"no":"7001021000","des":"約旦","eng":"Jordan"},{"no":"7001022000","des":"科威特","eng":"Kuwait"},{"no":"7001023000","des":"黎巴嫩","eng":"Lebanon"},{"no":"7001024000","des":"阿曼","eng":"Oman"},{"no":"7001025000","des":"卡達","eng":"Qatar"},{"no":"7001026000","des":"沙烏地阿拉伯","eng":"Saudi Arabia"},{"no":"7001027000","des":"敘利亞","eng":"Syria"},{"no":"7001028000","des":"土耳其","eng":"Turkey"},{"no":"7001029000","des":"阿拉伯大公國","eng":"United Arab Emirates"},{"no":"7001030000","des":"葉門","eng":"Yemen"},{"no":"7001031000","des":"孟加拉","eng":"Bangladesh"},{"no":"7001032000","des":"不丹","eng":"Bhutan"},{"no":"7001033000","des":"印度","eng":"India"},{"no":"7001034000","des":"馬爾地夫","eng":"Maldives"},{"no":"7001035000","des":"尼泊爾","eng":"Nepal"},{"no":"7001036000","des":"巴基斯坦","eng":"Pakistan"},{"no":"7001037000","des":"斯里蘭卡","eng":"Sri Lanka"},{"no":"7001038000","des":"蒙古","eng":"Mongolia"},{"no":"7001040000","des":"亞美尼亞","eng":"Armenia"},{"no":"7001041000","des":"亞塞拜然","eng":"Azerbaijan"},{"no":"7001044000","des":"喬治亞","eng":"Georgia"},{"no":"7001047000","des":"東帝汶","eng":"East Timor"},{"no":"7001048000","des":"哈薩克","eng":"Kazakhstan"},{"no":"7001049000","des":"吉爾吉斯","eng":"Kyrgyzstan"},{"no":"7001050000","des":"塔吉克","eng":"Tajikistan"},{"no":"7001051000","des":"土庫曼","eng":"Turkmenistan"},{"no":"7001052000","des":"烏茲別克","eng":"Uzbekistan"},{"no":"7001054000","des":"巴勒斯坦","eng":"Palestine"}],"eng":"Asia"},{"no":"7002000000","des":"大洋洲","n":[{"no":"7002001000","des":"澳洲","eng":"Australia"},{"no":"7002002000","des":"紐西蘭","eng":"New Zealand"},{"no":"7002003000","des":"巴布亞紐幾內亞","eng":"Papua New Guinea"},{"no":"7002004000","des":"庫克群島","eng":"Cook Islands"},{"no":"7002005000","des":"斐濟","eng":"Fiji"},{"no":"7002006000","des":"吉里巴斯","eng":"Kiribati"},{"no":"7002008000","des":"馬紹爾群島","eng":"Marshall Islands"},{"no":"7002009000","des":"密克羅尼西亞","eng":"Micronesia"},{"no":"7002010000","des":"諾魯","eng":"Nauru"},{"no":"7002011000","des":"紐埃","eng":"Niue"},{"no":"7002012000","des":"帛琉","eng":"Palau"},{"no":"7002013000","des":"薩摩亞","eng":"Samoa"},{"no":"7002014000","des":"索羅門群島","eng":"Solomon Islands"},{"no":"7002015000","des":"東加","eng":"Tonga"},{"no":"7002016000","des":"吐瓦魯","eng":"Tuvalu"},{"no":"7002017000","des":"萬那杜","eng":"Vanuatu"}],"eng":"Oceania"},{"no":"7003000000","des":"美洲","n":[{"no":"7003001000","des":"加拿大","eng":"Canada"},{"no":"7003002000","des":"美國","eng":"United States"},{"no":"7003003000","des":"貝里斯","eng":"Belize"},{"no":"7003004000","des":"哥斯大黎加","eng":"Costa Rica"},{"no":"7003005000","des":"薩爾瓦多","eng":"El Salvador"},{"no":"7003006000","des":"瓜地馬拉","eng":"Guatemala"},{"no":"7003007000","des":"宏都拉斯","eng":"Honduras"},{"no":"7003008000","des":"尼加拉瓜","eng":"Nicaragua"},{"no":"7003009000","des":"巴拿馬","eng":"Panama"},{"no":"7003010000","des":"烏拉圭","eng":"Uruguay"},{"no":"7003011000","des":"厄瓜多","eng":"Ecuador"},{"no":"7003012000","des":"哥倫比亞","eng":"Colombia"},{"no":"7003013000","des":"巴拉圭","eng":"Paraguay"},{"no":"7003014000","des":"巴西","eng":"Brazil"},{"no":"7003015000","des":"智利","eng":"Chile"},{"no":"7003016000","des":"玻利維亞","eng":"Bolivia"},{"no":"7003017000","des":"秘魯","eng":"Peru"},{"no":"7003018000","des":"蘇利南","eng":"Suriname"},{"no":"7003019000","des":"阿根廷","eng":"Argentina"},{"no":"7003021000","des":"墨西哥","eng":"Mexico"},{"no":"7003020000","des":"多明尼加","eng":"Dominican Republic"},{"no":"7003022000","des":"委內瑞拉","eng":"Venezuela"},{"no":"7003023000","des":"古巴","eng":"Cuba"},{"no":"7003024000","des":"牙買加","eng":"Jamaica"},{"no":"7003025000","des":"蓋亞那合作共和國","eng":"Cooperative Republic of Guyana"},{"no":"7003026000","des":"聖克里斯多福及尼維斯","eng":"Saint Kitts and Nevis"},{"no":"7003027000","des":"波多黎各自由邦","eng":"Commonwealth of Puerto Rico"},{"no":"7003028000","des":"多米尼克","eng":"Commonwealth of Dominica"},{"no":"7003029000","des":"巴哈馬","eng":"Commonwealth of The Bahamas"},{"no":"7003030000","des":"巴貝多","eng":"Barbados"},{"no":"7003031000","des":"千里達及托巴哥共和國","eng":"Republic of Trinidad and Tobago"},{"no":"7003032000","des":"阿魯巴","eng":"Aruba"},{"no":"7003033000","des":"海地共和國","eng":"Republic of Haiti"},{"no":"7003034000","des":"安地卡及巴布達","eng":"Antigua and Barbuda"},{"no":"7003035000","des":"聖露西亞","eng":"Saint Lucia"}],"eng":"Americas"},{"no":"7004000000","des":"歐洲","n":[{"no":"7004001000","des":"挪威","eng":"Norway"},{"no":"7004002000","des":"瑞典","eng":"Sweden"},{"no":"7004003000","des":"芬蘭","eng":"Finland"},{"no":"7004004000","des":"丹麥","eng":"Denmark"},{"no":"7004005000","des":"冰島","eng":"Iceland"},{"no":"7004006000","des":"阿爾巴尼亞","eng":"Albania"},{"no":"7004007000","des":"安道爾","eng":"Andorra"},{"no":"7004008000","des":"波士尼亞赫塞哥維納","eng":"Bosnia and Herzegovina"},{"no":"7004009000","des":"保加利亞","eng":"Bulgaria"},{"no":"7004010000","des":"克羅埃西亞","eng":"Croatia"},{"no":"7004011000","des":"賽普勒斯","eng":"Cyprus"},{"no":"7004012000","des":"希臘","eng":"Greece"},{"no":"7004013000","des":"義大利","eng":"Italy"},{"no":"7004014000","des":"馬其頓","eng":"North Macedonia"},{"no":"7004015000","des":"馬爾他","eng":"Malta"},{"no":"7004016000","des":"葡萄牙","eng":"Portugal"},{"no":"7004017000","des":"羅馬尼亞","eng":"Romania"},{"no":"7004018000","des":"聖馬利諾","eng":"San Marino"},{"no":"7004019000","des":"塞爾維亞和黑山","eng":"Serbia and Montenegro"},{"no":"7004020000","des":"斯洛維尼亞","eng":"Slovenia"},{"no":"7004021000","des":"西班牙","eng":"Spain"},{"no":"7004022000","des":"白俄羅斯","eng":"Belarus"},{"no":"7004023000","des":"愛沙尼亞","eng":"Estonia"},{"no":"7004024000","des":"拉脫維亞","eng":"Latvia"},{"no":"7004025000","des":"立陶宛","eng":"Lithuania"},{"no":"7004026000","des":"摩爾多瓦","eng":"Moldova"},{"no":"7004027000","des":"俄羅斯","eng":"Russia"},{"no":"7004028000","des":"烏克蘭","eng":"Ukraine"},{"no":"7004029000","des":"比利時","eng":"Belgium"},{"no":"7004030000","des":"法國","eng":"France"},{"no":"7004031000","des":"愛爾蘭","eng":"Ireland"},{"no":"7004032000","des":"盧森堡","eng":"Luxembourg"},{"no":"7004033000","des":"摩納哥","eng":"Monaco"},{"no":"7004034000","des":"荷蘭","eng":"Netherlands"},{"no":"7004035000","des":"英國","eng":"United Kingdom"},{"no":"7004036000","des":"奧地利","eng":"Austria"},{"no":"7004037000","des":"捷克","eng":"Czech Republic"},{"no":"7004038000","des":"德國","eng":"Germany"},{"no":"7004039000","des":"匈牙利","eng":"Hungary"},{"no":"7004040000","des":"列支敦斯登","eng":"Liechtenstein"},{"no":"7004041000","des":"波蘭","eng":"Poland"},{"no":"7004042000","des":"斯洛伐克","eng":"Slovakia"},{"no":"7004043000","des":"瑞士","eng":"Switzerland"},{"no":"7004044000","des":"梵蒂岡","eng":"Vatican City"}],"eng":"Europe"},{"no":"7005000000","des":"非洲","n":[{"no":"7005001000","des":"阿爾及利亞","eng":"Algeria"},{"no":"7005002000","des":"埃及","eng":"Egypt"},{"no":"7005003000","des":"利比亞","eng":"Libya"},{"no":"7005004000","des":"蘇丹","eng":"Sudan"},{"no":"7005005000","des":"突尼西亞","eng":"Tunisia"},{"no":"7005006000","des":"西撒哈拉","eng":"Western Sahara"},{"no":"7005007000","des":"摩洛哥","eng":"Morocco"},{"no":"7005008000","des":"中非","eng":"Central African Republic"},{"no":"7005009000","des":"喀麥隆","eng":"Cameroon"},{"no":"7005010000","des":"赤道幾內亞","eng":"Equatorial Guinea"},{"no":"7005011000","des":"加彭","eng":"Gabon"},{"no":"7005012000","des":"剛果","eng":"Congo"},{"no":"7005013000","des":"剛果(金)","eng":"Congo (DRC)"},{"no":"7005014000","des":"聖多美和普林西比","eng":"Sao Tome and Principe"},{"no":"7005015000","des":"安哥拉","eng":"Angola"},{"no":"7005016000","des":"波札那","eng":"Botswana"},{"no":"7005017000","des":"賴索托","eng":"Lesotho"},{"no":"7005018000","des":"馬達加斯加","eng":"Madagascar"},{"no":"7005019000","des":"馬拉威","eng":"Malawi"},{"no":"7005020000","des":"模里西斯","eng":"Mauritius"},{"no":"7005021000","des":"莫三比克","eng":"Mozambique"},{"no":"7005022000","des":"納米比亞","eng":"Namibia"},{"no":"7005023000","des":"史瓦濟蘭","eng":"Eswatini"},{"no":"7005024000","des":"南非","eng":"South Africa"},{"no":"7005025000","des":"坦尚尼亞","eng":"Tanzania"},{"no":"7005026000","des":"尚比亞","eng":"Zambia"},{"no":"7005027000","des":"辛巴威","eng":"Zimbabwe"},{"no":"7005028000","des":"留尼旺","eng":"Reunion"},{"no":"7005029000","des":"聖赫倫那","eng":"Saint Helena"},{"no":"7005030000","des":"衣索比亞","eng":"Ethiopia"},{"no":"7005031000","des":"蒲隆地","eng":"Burundi"},{"no":"7005032000","des":"厄利垂亞","eng":"Eritrea"},{"no":"7005033000","des":"吉布地","eng":"Djibouti"},{"no":"7005034000","des":"葛摩","eng":"Comoros"},{"no":"7005035000","des":"肯亞","eng":"Kenya"},{"no":"7005036000","des":"盧安達","eng":"Rwanda"},{"no":"7005037000","des":"塞席爾","eng":"Seychelles"},{"no":"7005038000","des":"索馬利亞","eng":"Somalia"},{"no":"7005039000","des":"坦尚尼亞","eng":"Tanzania"},{"no":"7005040000","des":"烏干達","eng":"Uganda"},{"no":"7005041000","des":"貝南","eng":"Benin"},{"no":"7005042000","des":"布吉納法索","eng":"Burkina Faso"},{"no":"7005043000","des":"查德","eng":"Chad"},{"no":"7005044000","des":"赤道幾內亞","eng":"Equatorial Guinea"},{"no":"7005045000","des":"多哥","eng":"Togo"},{"no":"7005046000","des":"維德角","eng":"Cape Verde"},{"no":"7005047000","des":"甘比亞","eng":"Gambia"},{"no":"7005048000","des":"幾內亞","eng":"Guinea"},{"no":"7005049000","des":"幾內亞比索","eng":"Guinea-Bissau"},{"no":"7005050000","des":"迦納","eng":"Ghana"},{"no":"7005051000","des":"加彭","eng":"Gabon"},{"no":"7005052000","des":"喀麥隆","eng":"Cameroon"},{"no":"7005053000","des":"象牙海岸","eng":"Ivory Coast"},{"no":"7005054000","des":"賴比瑞亞","eng":"Liberia"},{"no":"7005055000","des":"馬利","eng":"Mali"},{"no":"7005056000","des":"尼日","eng":"Niger"},{"no":"7005057000","des":"奈及利亞","eng":"Nigeria"},{"no":"7005058000","des":"獅子山","eng":"Sierra Leone"},{"no":"7005059000","des":"塞內加爾","eng":"Senegal"},{"no":"7005060000","des":"聖多美和普林西比","eng":"Sao Tome and Principe"},{"no":"7005061000","des":"南蘇丹共和國","eng":"Republic of South Sudan"},{"no":"7005062000","des":"茅利塔尼亞伊斯蘭共和國","eng":"Islamic Republic of Mauritania"}],"eng":"Africa"}]