Legislative Yuan MCP server

🏛️ ly-mcp

<!-- mcp-name: io.github.narumiruna/ly-mcp -->

ly-mcp 是一個串接台灣立法院 API v2 的 Model Context Protocol (MCP) 伺服器，提供議案、委員會、公報、會議紀錄與相關文件等資料查詢能力。

✨ 功能

此 MCP 伺服器提供 10 大類、共 42 個工具：

📊 統計

• getstat**：取得立法院 API 的統計與概覽資訊。

📄 議案

• listbills**：列出議案，可依屆期、會期、類別、提案人等條件篩選。
• getbill**：取得特定議案的完整資訊，回傳完整 JSON。
• getbillrelatedbills**：查詢相關議案與其關聯。
• getbillmeets：取得議案在各會議中的審議紀錄，可依會議、出席委員、委員會及關聯議案或法律篩選，並指定輸出欄位。
• getbilldochtml**：取得特定議案的 HTML 文件內容。

🏢 委員會

• listcommittees**：列出立法院委員會，可依整數類別代碼與委員會代號篩選。
• getcommittee**：取得特定委員會的詳細資訊。
• getcommitteemeets：取得委員會會議紀錄與議事內容。

📰 公報

• listgazettes**：列出立法院公報，可依卷期與公報編號篩選。
• getgazette**：取得特定公報的詳細資訊。
• getgazetteagendas：取得特定公報中的議程或目錄內容，可另依公報編號、卷、期、冊別等查詢條件篩選。
• listgazetteagendas：列出公報目錄，可依卷、期、冊別、屆期與會議日期等條件篩選。
• getgazetteagenda：取得特定公報目錄項目的詳細資訊。

🎙️ 質詢

• listinterpellations**：列出質詢資料，可依委員、屆期、會期與會議代碼篩選。
• getinterpellation**：取得特定質詢的詳細資訊。
• getlegislatorinterpellations：取得特定立法委員作為質詢委員的質詢資料。

🎥 IVOD（網路電視）

• listivods**：列出 IVOD 影片，可依屆期、會期、委員會、委員與影片類型篩選。
• getivod**：取得特定 IVOD 影片的詳細資訊，包含影片網址、逐字稿與公報內容。
• getmeetivods：取得特定會議相關的 IVOD 影片。

⚖️ 法律

• listlaws**：列出法律，可依法律編號、類別（母法或子法）、母法編號、狀態與主管機關篩選。
• getlaw**：取得特定法律的完整資訊，包含基本資料、法條與版本資訊。
• getlawprogress：取得特定法律的未議決進度列表。
• getlawbills：取得特定法律相關的議案，可搭配篩選條件。
• getlawversions：取得特定法律的歷史版本紀錄，包含修正內容、提案人與進度。
• listlawversions：跨法律列出法律版本，可依法律編號、版本編號、日期、動作、進度與現行版本狀態篩選。
• getlawversion：依版本 ID 取得特定法律版本的詳細資訊。
• getlawversioncontents**：取得特定法律版本包含的法條內容。
• listlawcontents：列出法條內容，可依法律編號、版本 ID、條號、現行版狀態與版本追蹤篩選。
• getlawcontent：依法條內容 ID 取得特定法條的詳細資訊。

🗓️ 會議

• listmeets**：列出立法院會議，可依屆期、會期、會議種類、出席委員、日期、委員會代號與會議編號篩選。
• getmeet**：依會議 ID 或代碼取得特定會議的詳細資訊。
• getmeetivods：取得特定會議相關的 IVOD 影片，可搭配篩選條件。
• getmeetbills：取得特定會議討論的議案，可依議案條件篩選。
• getmeetinterpellations：取得特定會議中的質詢資料，可搭配篩選條件。

👤 立法委員

• listlegislators**：列出立法委員，可依屆期、黨籍、選區、委員 ID 與姓名篩選。
• getlegislator**：依屆期與姓名取得特定立法委員的詳細資訊。
• getlegislatorproposebills**：取得特定立法委員作為提案人的議案，可依議案條件篩選。
• getlegislatorcosignbills**：取得特定立法委員作為連署人的議案，可依議案條件篩選。
• getlegislatormeets：取得特定立法委員出席的會議，可依會議條件篩選。
• getlegislatorinterpellations：取得特定立法委員的質詢資料，可搭配篩選條件。

🗳️ 表決

• listvotes**：列出表決紀錄，可依屆期、會議、表決型態、委員投票立場與公報文件篩選。
• getvote**：依表決代碼取得完整表決內容。
• getvotemeets：取得特定表決所屬的會議，可搭配會議、委員會與關聯議案條件篩選。

🔗 API 來源

此 MCP 伺服器使用 立法院 API v2 作為資料來源，提供台灣立法院議案與議事資料。

📦 工具回應格式

MCP 工具呼叫成功時，會回傳立法院 API 的原始 JSON payload。呼叫失敗時，會回傳可由程式判讀的 JSON 錯誤封包：

{
  "ok": false,
  "error": {
    "type": "http_status",
    "message": "Upstream API returned HTTP 404 for https://ly.govapi.tw/v2/bills/invalid_bill_number",
    "url": "https://ly.govapi.tw/v2/bills/invalid_bill_number",
    "status_code": 404,
    "response_excerpt": "not found"
  }
}

目前的錯誤 type 包含 httpstatus、timeout、networkerror、invalidjson 與 unexpectederror。

🚀 安裝與使用

⚡ 快速開始

使用 uvx 安裝並執行伺服器：

uvx lymcp@latest

🧩 MCP Client 設定

將此伺服器加入你的 MCP client 設定，例如 Claude Desktop。

PyPI

{
  "mcpServers": {
    "lymcp": {
      "command": "uvx",
      "args": ["lymcp@latest"]
    }
  }
}

GitHub

Shortened. The full README is on GitHub.