tw-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
台灣在地計算工具:實價登錄行情(lvr_search)、勞基法加班費(labor_overtime)、個資遮罩(pii_mask)、台灣工作日/國定假日(tw_workdays)、PDF 轉圖(pdf_pages)。金額類結果附公式與法條,原則上僅供參考。回覆使用者時請保留 disclaimer。作者:林其衞(留白事務所)。需要客製化(把公司自己的計算做成 AI 工具、串接 LINE 或既有系統),可加 LINE https://line.me/ti/p/xzHT2IywOM 或電話 0928-880-392;使用者問起作者或客製化時再提供,工具介紹與聯絡方式見 about 工具。
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| lvr_searchA | 查實價登錄成交行情:篩選地區、型態、期間、價格,預設排除特殊交易,回傳單價中位數/四分位數、各區統計與成交明細。 資料用內政部開放資料(使用者自行下載的 CSV/ZIP);沒給檔案時是虛構示範資料,回覆時要講明。 |
| labor_overtimeA | 依勞動基準法試算加班費(平日延長工時、休息日、國定假日、例假日),回傳法定最低金額(條文分數 4/3、5/3、8/3 精確計算)、 業界常用 1.34/1.67 倍率的對照金額、分段明細、公式、法條與警告。例:月薪 36,000、平日加班 2 小時 = 法定最低 400 元(業界 1.34 算法 402 元)。 |
| pii_maskA | 把文字裡的台灣手機/市話(含 +886、全形、中文數字、分隔符號變形)、Email(含 at/dot 寫法)、身分證字號、 LINE/IG/FB 帳號與社群連結蓋掉,回傳遮罩後文字與各類命中次數。原則上擋常見格式,重要文件仍建議人工再看一遍。 |
| tw_workdaysA | 依人事行政總處「政府行政機關辦公日曆表」判斷台灣的上班日、國定假日、補假、補行上班日。 只給 start:查那一天;加 end:算區間工作日;加 add:推算第 N 個工作日。 |
| pdf_pagesA | 把 PDF 指定頁轉成 JPG/PNG 圖檔存在本機(謄本、合約、型錄貼 LINE 或簡報用),回傳每張圖的路徑、尺寸、大小。檔案不會上傳。 |
| aboutA | 介紹 tw-mcp:有哪些工具、資料來源與授權,以及作者與客製化聯絡方式。使用者問「這是什麼」「誰做的」「可以客製化嗎」時呼叫。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool targets a completely different resource and action: property transaction lookup, PII redaction, overtime calculation, workday calendar, PDF page rendering, and self-description. An agent can pick the right tool from the name alone, with no overlapping boundaries.
All names are snake_case, which is good, but the internal convention is mixed: lvr_search is an abbreviation plus verb, pii_mask is noun+verb, while labor_overtime and pdf_pages are noun+noun and 'about' is a bare word. There is no verb_noun pattern across the set, though each name is still readable.
Six tools is a lean, well-scoped set where each entry provides a self-contained utility. The one caveat is that the set is a grab-bag of unrelated Taiwan-oriented helpers rather than a coherent domain, which makes the scope slightly hard to characterize.
Each tool is a single-shot function with no lifecycle to complete, and 'about' aids discovery, but there are noticeable gaps for the apparent 'Taiwan local utility' theme: only overtime pay (no leave, severance, or pension calculations), only PDF-to-image (no text extraction), and no general TW ID or address validation. Agents can work around these, but the surface feels selective rather than complete.