Legislative Yuan API

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

- 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：取得特定立法委員作為質詢委員的質詢資料。

- 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：取得特定表決所屬的會議，可搭配會議、委員會與關聯議案條件篩選。

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

{ "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" } }

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

{ "mcpServers": { "lymcp": { "command": "uvx", "args": [ "--from", "git+https://github.com/narumiruna/ly-mcp", "lymcp" ] } } }

{ "mcpServers": { "lymcp": { "command": "uv", "args": [ "run", "--directory", "/path/to/ly-mcp", "lymcp" ] } } }

{ "mcpServers": { "lymcp": { "command": "docker", "args": [ "run", "--rm", "-i", "narumi/ly-mcp:latest" ] } } }

套件也提供ly指令，讓 agents 或 shell workflow 可以直接從 terminal 查詢立法院 API。CLI 預設輸出 pretty JSON，失敗時會輸出和 MCP tools 相同的 JSON error envelope 並回傳非 0 exit code。

ly --help ly stat ly bills list --term 11 --bill-type 法律案 --limit 5 ly bills get 202110213410000 ly bills meets 202110213410000 --meeting-code 院會-11-2-6 --fields 會議代碼,日期 ly gazettes agendas 1137701 --gazette-number 1137701 --issue 77 ly laws versions 09200015 --limit 5 ly meets bills 院會-11-2-3 --term 11 --limit 5 ly legislators propose-bills 11 韓國瑜 --limit 5 ly votes list --term 11 --voting-member 黃國昌 --limit 5 ly votes get 1141921_00002_591 ly votes meets 1141921_00002_591 --term 11

- ly bills ...查議案、關聯議案、審議會議與議案本文 HTML。
- ly laws ...、ly law-versions ...、ly law-contents ...查法律、修法版本與法條內容。
- ly meets ...查會議、會議中的議案、質詢與 IVOD。
- ly legislators ...查立法委員、提案、連署、出席會議與質詢。
- ly gazettes ...、ly gazette-agendas ...查公報與公報目錄。
- ly committees ...、ly interpellations ...、ly ivods ...查委員會、質詢與網路電視資料。
- ly votes ...查表決列表、表決詳情與所屬會議。

# 單行 JSON，方便 pipe 給其他工具 ly --compact bills list --term 11 --limit 1 # 將成功結果寫入檔案 ly --output bills.json bills list --term 11 --limit 20 # 傳遞上游 output_fields ly bills list --term 11 --fields 議案編號,案由,提案日期

- 「列出第11屆的所有法律提案」
- 「查詢立法委員王美花的提案紀錄」
- 「以今天的台北日期為準，最近已發生的院會討論了哪些議案？」
- 「下一場已排程的院會是什麼時候？」
- 「查詢勞動基準法的修法歷程」
- 「第11屆第1會期有哪些委員會會議？」
- 「黃國昌在第11屆參與過哪些表決？各自投了什麼立場？」

- latest known：使用上游預設排序，包含未來已排程的紀錄。
- latest occurred：只考慮相關日期在參考日期當天或之前的紀錄。
- next scheduled：只考慮相關日期晚於參考日期的紀錄。

伺服器也提供常見工作流程用的 MCP prompts：latest_plenary_meeting_bills、law_amendment_history、legislator_proposal_record、legislator_interpellations、committee_meeting_lookup與legislator_vote_record。可閱讀lymcp://query-semantics與lymcp://workflow-reference，取得日期語意、篩選條件、ID 欄位與工作流程步驟的精簡指引。

git clone https://github.com/narumiruna/ly-mcp cd ly-mcp uv sync

此 repository 已包含供本機 Codex CLI 開發使用的.codex/config.toml。從 repository root 啟動 Codex CLI 時，可透過uv run lymcp使用已設定的lymcpMCP server。

# 執行預設離線測試套件並產生 coverage just test # 直接執行預設離線測試套件 uv run pytest -v -s # 手動執行會呼叫立法院 API 的 live tests just test-live

預設 pytest 設定會排除標記為live的測試，因此 CI 與一般本機執行會使用tests/data中的 fixture-backed samples。只有在上游 API 回應形狀改變時，才應有意識地更新這些 JSON samples。

# 執行 linter just lint # 執行 type checker just type

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

City hiring-compliance MCP server with regulation search and full audit risk scoring.

Brazilian Federal Senate open data over MCP — 90 tools across the legislative process, Senate administration (CEAPS expenses, payroll, contracts) and the e-Cidadania portal. Cloudflare Workers, Streamable HTTP, no auth. Responses in pt-BR.

This MCP (Model Context Protocol) server provides integration with Wiki.JS for searching and listing pages from Agent Voice Response Wiki.JS instance.

Fetch, convert, and search AWS documentation pages, with recommendations for related content.

Production-ready RAG out of the box to search and retrieve data from your own documents.

Quran-focused MCP server for ayah translation, tafsir, mutashabihat lookups, recitation playlists, and prayer times.

Vectorize MCP server for advanced retrieval, Private Deep Research, Anything-to-Markdown file extraction and text chunking.

Provides AI assistants with intelligent access to ML textbook content for creating accurate, source-grounded documentation.

一条工務店で家を建てた施主「ろれさん」のブログ記事と、YouTube/X/Instagram/Web から集めた約3,000件の家づくり Tips を横断検索できる MCP サーバ。すべての結果に出典URLが付きます。

Search and retrieve academic papers from arXiv based on keywords.