ly-mcp

Un servidor del Protocolo de Contexto de Modelo (MCP) para la API v2 del Yuan Legislativo de Taiwán, que proporciona acceso integral a proyectos de ley, comités, gacetas, actas de reuniones y documentos relacionados.

Características

Este servidor MCP proporciona 36 herramientas en 9 categorías:

Estadísticas

• get_stat: Obtener estadísticas e información general de la API del Yuan Legislativo

Proyectos de ley (議案)

• list_bills: Listar proyectos de ley con filtros opcionales por legislatura, sesión, categoría, proponente y otros criterios

• get_bill: Obtener información integral sobre proyectos de ley específicos (devuelve el JSON completo)

• get_bill_related_bills: Consultar proyectos de ley relacionados y sus asociaciones

• get_bill_meets: Acceder a los registros de deliberación de proyectos de ley de varias reuniones

• get_bill_doc_html: Recuperar el contenido del documento HTML para proyectos de ley específicos

Comités (委員會)

• list_committees: Listar los comités del Yuan Legislativo con filtros opcionales

• get_committee: Obtener información detallada sobre comités específicos

• get_committee_meets: Acceder a los registros y actas de las reuniones de los comités

Gacetas (公報)

• list_gazettes: Listar las gacetas del Yuan Legislativo con filtros opcionales por volumen e ID de gaceta

• get_gazette: Obtener información detallada sobre gacetas específicas

• get_gazette_agendas: Obtener agendas/contenidos de gacetas específicas

• list_gazette_agendas: Listar todas las agendas de las gacetas con filtros opcionales por legislatura, fecha de reunión, etc.

• get_gazette_agenda: Obtener información detallada sobre elementos específicos de la agenda de la gaceta

Interpelaciones (質詢)

• list_interpellations: Listar interpelaciones con filtros opcionales por miembro, legislatura, sesión y código de reunión

• get_interpellation: Obtener información detallada sobre interpelaciones específicas

• get_legislator_interpellations: Obtener interpelaciones donde un legislador específico es el miembro que interroga

IVODs (Televisión por Internet)

• list_ivods: Listar grabaciones de IVOD (Video bajo demanda por Internet) con filtros opcionales por legislatura, sesión, comité, miembro y tipo de video

• get_ivod: Obtener información detallada sobre grabaciones de IVOD específicas, incluyendo URLs de video, transcripciones y contenido de la gaceta

• get_meet_ivods: Obtener grabaciones de IVOD relacionadas con reuniones específicas

Leyes (法律)

• list_laws: Listar leyes con filtros opcionales por número de ley, categoría (ley principal/ley secundaria), número de ley principal, estado y autoridad

• get_law: Obtener información integral sobre leyes específicas, incluyendo datos básicos, artículos e información de versión

• get_law_progress: Obtener la lista de progreso pendiente para leyes específicas

• get_law_bills: Obtener proyectos de ley relacionados con leyes específicas con filtros opcionales

• get_law_versions: Obtener registros de versiones históricas para leyes específicas, incluyendo cambios, proponentes y progreso

• list_law_contents: Listar artículos/contenidos de leyes con filtros opcionales por número de ley, ID de versión, número de artículo, estado de la versión actual y seguimiento de versión

• get_law_content: Obtener información detallada sobre artículos/contenidos de leyes específicos usando el ID de contenido de la ley

Reuniones (會議)

• list_meets: Listar reuniones del Yuan Legislativo con filtros opcionales por legislatura, sesión, tipo de reunión, asistentes, fecha, código de comité e ID de reunión

• get_meet: Obtener información detallada sobre reuniones específicas usando el ID/código de reunión

• get_meet_ivods: Obtener grabaciones de IVOD (Video bajo demanda por Internet) relacionadas con reuniones específicas con filtros opcionales

• get_meet_bills: Obtener proyectos de ley discutidos en reuniones específicas con filtros opcionales por criterios de proyecto de ley

• get_meet_interpellations: Obtener interpelaciones que ocurrieron en reuniones específicas con filtros opcionales

Legisladores (立法委員)

• list_legislators: Listar legisladores con filtros opcionales por legislatura, partido, nombre del distrito, ID de legislador y nombre

• get_legislator: Obtener información detallada sobre legisladores específicos por legislatura y nombre

• get_legislator_propose_bills: Obtener proyectos de ley propuestos por un legislador específico con filtros opcionales por criterios de proyecto de ley

• get_legislator_cosign_bills: Obtener proyectos de ley cofirmados por un legislador específico con filtros opcionales por criterios de proyecto de ley

• get_legislator_meets: Obtener reuniones a las que asistió un legislador específico con filtros opcionales por criterios de reunión

• get_legislator_interpellations: Obtener interpelaciones realizadas por un legislador específico con filtros opcionales

Fuente de la API

Este servidor MCP utiliza la API v2 del Yuan Legislativo como fuente de datos, proporcionando información sobre los proyectos de ley y procedimientos del Yuan Legislativo de Taiwán.

Instalación y uso

Inicio rápido

Instale y ejecute el servidor usando uvx:

uvx lymcp@latest

Configuración del cliente MCP

Agregue el servidor a la configuración de su cliente MCP (por ejemplo, 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"
      ]
    }
  }
}

Desarrollo local

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

Ejemplos de prompts

Una vez conectado al servidor MCP, puede hacer preguntas a su LLM como:

• "列出第11屆的所有法律提案" (Listar todos los proyectos de ley de la 11ª legislatura)

• "查詢立法委員王美花的提案紀錄" (Consultar el registro de proyectos de ley propuestos por la legisladora Wang Mei-hua)

• "最近一次院會討論了哪些議案？" (¿Qué proyectos de ley se discutieron en la sesión plenaria más reciente?)

• "查詢勞動基準法的修法歷程" (Consultar el historial de enmiendas de la Ley de Normas Laborales)

• "第11屆第1會期有哪些委員會會議？" (¿Qué reuniones de comité se llevaron a cabo en la 1ª sesión de la 11ª legislatura?)

Desarrollo

Requisitos previos

• Python 3.12+

• Gestor de paquetes uv

• Ejecutor de comandos just

Configuración

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

Ejecución del inspector MCP

just dev

Ejecución de pruebas

# Run full test suite with coverage
just test

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

Calidad del código

# Run linter
just lint

# Run type checker
just type

Licencia

MIT