@jurislm/judicial-mcp

MCP (Model Context Protocol) server for Taiwan Judicial Yuan — provides 7 tools for accessing open data and judgments via natural language.

Tools

Authentication (2 tools)

• auth_token — Get authorization token for judgment API (uses JUDICIAL_USER / JUDICIAL_PASSWORD env vars by default)
• member_token — Get member token for open data API (uses JUDICIAL_USER / JUDICIAL_PASSWORD env vars by default)

Judgments (2 tools)

• list_judgments — Get judgment change list (requires auth_token)
• get_judgment — Get judgment content by JID (requires auth_token)

Open Data (3 tools)

• list_categories — List topic categories (requires member_token)
• list_resources — List data sources for a category (requires member_token + categoryNo)
• download_file — Download a data file with pagination support (requires member_token + fileSetId)

Setup

Environment Variables

JUDICIAL_USER=your_username
JUDICIAL_PASSWORD=your_password

Usage with Claude Code (via bunx)

Add to your MCP configuration (.mcp.json or ~/.claude/settings.json):

{
  "mcpServers": {
    "judicial": {
      "command": "bunx",
      "args": ["@jurislm/judicial-mcp@latest"],
      "env": {
        "JUDICIAL_USER": "your_username",
        "JUDICIAL_PASSWORD": "your_password"
      }
    }
  }
}

Usage with Claude Code Plugin (jurislm-tools)

If you use the jurislm-tools Claude Code plugin, jt:judicial is included:

/plugin marketplace update jurislm-tools

Then set environment variables in ~/.zshenv:

export JUDICIAL_USER=your_username
export JUDICIAL_PASSWORD=your_password

Development

npm install
npm test           # Run tests
npm run lint       # oxlint

License

MIT