ly-mcp

PyPI version Python Docker License: MIT

台湾立法院 API v2 用の Model Context Protocol (MCP) サーバーであり、法案、委員会、公報、会議録、および関連文書への包括的なアクセスを提供します。

機能

この MCP サーバーは、9 つのカテゴリにわたる 36 のツールを提供します。

統計 (Statistics)

get_stat: 立法院 API の統計および概要情報を取得

法案 (Bills)

list_bills: 会期、セッション、カテゴリ、提案者などの条件でフィルタリングして法案を一覧表示
get_bill: 特定の法案に関する包括的な情報を取得（完全な JSON を返します）
get_bill_related_bills: 関連する法案とその関連性を照会
get_bill_meets: さまざまな会議での法案審議記録にアクセス
get_bill_doc_html: 特定の法案の HTML ドキュメントコンテンツを取得

委員会 (Committees)

list_committees: オプションのフィルタを使用して立法院の委員会を一覧表示
get_committee: 特定の委員会に関する詳細情報を取得
get_committee_meets: 委員会の会議記録および議事録にアクセス

公報 (Gazettes)

list_gazettes: 巻数や公報 ID でフィルタリングして立法院公報を一覧表示
get_gazette: 特定の公報に関する詳細情報を取得
get_gazette_agendas: 特定の公報から議題/内容を取得
list_gazette_agendas: 会期、会議日などでフィルタリングしてすべての公報議題を一覧表示
get_gazette_agenda: 特定の公報議題項目に関する詳細情報を取得

質疑 (Interpellations)

list_interpellations: 議員、会期、セッション、会議コードでフィルタリングして質疑を一覧表示
get_interpellation: 特定の質疑に関する詳細情報を取得
get_legislator_interpellations: 特定の立法委員が質問者である質疑を取得

IVOD (インターネットテレビ)

list_ivods: 会期、セッション、委員会、議員、ビデオタイプでフィルタリングして IVOD (Internet Video On Demand) 録画を一覧表示
get_ivod: ビデオ URL、トランスクリプト、公報内容を含む、特定の IVOD 録画に関する詳細情報を取得
get_meet_ivods: 特定の会議に関連する IVOD 録画を取得

法律 (Laws)

list_laws: 法律番号、カテゴリ（母法/子法）、親法番号、ステータス、権限でフィルタリングして法律を一覧表示
get_law: 基本データ、条文、バージョン情報を含む、特定の法律に関する包括的な情報を取得
get_law_progress: 特定の法律の未決定の進捗リストを取得
get_law_bills: オプションのフィルタを使用して特定の法律に関連する法案を取得
get_law_versions: 変更点、提案者、進捗を含む、特定の法律の履歴バージョン記録を取得
list_law_contents: 法律番号、バージョン ID、条文番号、現在のバージョンステータス、バージョン追跡でフィルタリングして法律の条文/内容を一覧表示
get_law_content: 法律コンテンツ ID を使用して、特定の法律の条文/内容に関する詳細情報を取得

会議 (Meets)

list_meets: 会期、セッション、会議タイプ、出席者、日付、委員会コード、会議 ID でフィルタリングして立法院の会議を一覧表示
get_meet: 会議 ID/コードを使用して、特定の会議に関する詳細情報を取得
get_meet_ivods: オプションのフィルタを使用して、特定の会議に関連する IVOD 録画を取得
get_meet_bills: 法案条件でフィルタリングして、特定の会議で議論された法案を取得
get_meet_interpellations: オプションのフィルタを使用して、特定の会議で行われた質疑を取得

立法委員 (Legislators)

list_legislators: 会期、政党、選挙区名、立法委員 ID、名前でフィルタリングして立法委員を一覧表示
get_legislator: 会期と名前で特定の立法委員に関する詳細情報を取得
get_legislator_propose_bills: 法案条件でフィルタリングして、特定の立法委員が提案した法案を取得
get_legislator_cosign_bills: 法案条件でフィルタリングして、特定の立法委員が共同署名した法案を取得
get_legislator_meets: 会議条件でフィルタリングして、特定の立法委員が出席した会議を取得
get_legislator_interpellations: オプションのフィルタを使用して、特定の立法委員が行った質疑を取得

API ソース

この MCP サーバーは、Legislative Yuan API v2 をデータソースとして使用し、台湾立法院の法案や議事に関する情報を提供します。

インストールと使用方法

クイックスタート

uvx を使用してサーバーをインストールおよび実行します：

uvx lymcp@latest

MCP クライアント設定

MCP クライアント設定（例：Claude Desktop）にサーバーを追加します：

PyPI

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

GitHub

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

Docker

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

プロンプト例

MCP サーバーに接続したら、LLM に次のような質問ができます：

"列出第11屆的所有法律提案" (第11期のすべての法律案をリストアップして)
"查詢立法委員王美花的提案紀錄" (立法委員王美花の提案記録を照会して)
"最近一次院會討論了哪些議案？" (直近の院会で議論された法案は？)
"查詢勞動基準法的修法歷程" (労働基準法の改正履歴を照会して)
"第11屆第1會期有哪些委員會會議？" (第11期第1会期にはどのような委員会会議がありましたか？)

開発

前提条件

Python 3.12+
uv パッケージマネージャー
just コマンドランナー

セットアップ

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

MCP インスペクターの実行

just dev

テストの実行

# Run full test suite with coverage
just test

# Run tests with verbose output
uv run pytest -v -s

コード品質

# Run linter
just lint

# Run type checker
just type

ライセンス

MIT

Taiwan Legislative Yuan MCP Server