lymcp 0.1.4

No project description provided

ly-mcp

A Model Context Protocol (MCP) server for Taiwan's Legislative Yuan API v2, providing bill search, detailed information, related documents, and meeting records.

Features

This MCP server provides the following tools:

• search_bills: Search bills by term, session, category, proposer, and other criteria
• get_bill_detail: Get comprehensive information about specific bills (returns complete JSON)
• get_bill_related_bills: Query related bills and their associations
• get_bill_doc_html: Retrieve HTML document content for specific bills
• get_bill_meets: Access bill deliberation records from various meetings

API Source

This MCP server uses the Legislative Yuan API v2 as its data source, providing information about Taiwan's Legislative Yuan bills and proceedings.

Installation & Usage

Quick Start

Install and run the server using uvx:

uvx lymcp@latest

MCP Client Configuration

Add the server to your MCP client configuration (e.g., 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"
      ]
    }
  }
}

Local Development

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

Development

Prerequisites

• Python 3.12+
• uv package manager

Setup

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

Running Tests

# Run full test suite with coverage
make test

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

Code Quality

# Run linter
make lint

# Run type checker
make type

# Run both linter and type checker
uv run ruff check .
uv run mypy .

License

MIT