🏛️ ly-mcp

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

✨ 功能

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

📊 統計

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

📄 議案

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

🏢 委員會

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

📰 公報

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

🎙️ 質詢

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

🎥 IVOD（網路電視）

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

⚖️ 法律

• list_laws：列出法律，可依法律編號、類別（母法或子法）、母法編號、狀態與主管機關篩選。
• get_law：取得特定法律的完整資訊，包含基本資料、法條與版本資訊。
• get_law_progress：取得特定法律的未議決進度列表。
• get_law_bills：取得特定法律相關的議案，可搭配篩選條件。
• get_law_versions：取得特定法律的歷史版本紀錄，包含修正內容、提案人與進度。
• list_law_versions：跨法律列出法律版本，可依法律編號、版本編號、日期、動作、進度與現行版本狀態篩選。
• get_law_version：依版本 ID 取得特定法律版本的詳細資訊。
• get_law_version_contents：取得特定法律版本包含的法條內容。
• list_law_contents：列出法條內容，可依法律編號、版本 ID、條號、現行版狀態與版本追蹤篩選。
• get_law_content：依法條內容 ID 取得特定法條的詳細資訊。

🗓️ 會議

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

👤 立法委員

• list_legislators：列出立法委員，可依屆期、黨籍、選區、委員 ID 與姓名篩選。
• get_legislator：依屆期與姓名取得特定立法委員的詳細資訊。
• get_legislator_propose_bills：取得特定立法委員作為提案人的議案，可依議案條件篩選。
• get_legislator_cosign_bills：取得特定立法委員作為連署人的議案，可依議案條件篩選。
• get_legislator_meets：取得特定立法委員出席的會議，可依會議條件篩選。
• get_legislator_interpellations：取得特定立法委員的質詢資料，可搭配篩選條件。

🗳️ 表決

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

🔗 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 包含 http_status、timeout、network_error、invalid_json 與 unexpected_error。

🚀 安裝與使用

⚡ 快速開始

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

uvx lymcp@latest

🧩 MCP Client 設定

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

PyPI

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

GitHub

{
  "mcpServers": {
    "lymcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://

... [View full README on GitHub](https://github.com/narumiruna/ly-mcp#readme)