ly-mcp

Сервер протокола контекста модели (MCP) для API v2 Законодательного Юаня Тайваня, обеспечивающий комплексный доступ к законопроектам, комитетам, вестникам, протоколам заседаний и сопутствующим документам.

Функции

Этот MCP-сервер предоставляет 36 инструментов в 9 категориях:

Статистика

• 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: Список вестников Законодательного Юаня с дополнительными фильтрами по тому и ID вестника

• 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, включая URL-адреса видео, стенограммы и содержание вестника

• get_meet_ivods: Получение записей IVOD, относящихся к конкретным заседаниям

Законы (法律)

• list_laws: Список законов с дополнительными фильтрами по номеру закона, категории (основной закон/подзаконный акт), номеру родительского закона, статусу и органу власти

• get_law: Получение исчерпывающей информации о конкретных законах, включая основные данные, статьи и информацию о версии

• get_law_progress: Получение списка нерешенного прогресса для конкретных законов

• get_law_bills: Получение законопроектов, связанных с конкретными законами, с дополнительными фильтрами

• get_law_versions: Получение записей об исторических версиях для конкретных законов, включая изменения, инициаторов и прогресс

• list_law_contents: Список статей/содержания законов с дополнительными фильтрами по номеру закона, ID версии, номеру статьи, статусу текущей версии и отслеживанию версий

• get_law_content: Получение подробной информации о конкретных статьях/содержании закона с использованием ID содержания закона

Заседания (會議)

• list_meets: Список заседаний Законодательного Юаня с дополнительными фильтрами по сроку полномочий, сессии, типу заседания, участникам, дате, коду комитета и ID заседания

• 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: Получение запросов, сделанных конкретным законодателем, с дополнительными фильтрами

Источник 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會期有哪些委員會會議？" (Какие заседания комитетов проводились в 1-й сессии 11-го созыва?)

Разработка

Предварительные требования

• 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