Skip to content

jurislm/judicial-mcp

v1.8.2MIT

Taiwan judicial judgments and regulations with official source evidence.

Changelog

1.8.2 (2026-10-29)

Bug Fixes

  • statutes: bound lookup attempts and retry aborted streams (c792016)
  • statutes: retry transient regulation name lookup once (b4d0942)
  • statutes: retry transient regulation name lookup once (e64fbae)

1.8.1 (2026-10-29)

Bug Fixes

  • readme: clarify login requirements by tool (19d2e25)
  • readme: clarify tool login requirements (ace2d89)
  • readme: export login environment variables (2c6a7af)
  • readme: include login environment variables (e9d52d4)

1.8.0 (2026-10-29)

Features

  • plugin: install Judicial MCP through Codex marketplace (JUR-979) (#34) (39be2a3)

1.7.0 (2026-10-29)

Features

  • statutes: verify article commencement with official evidence (JUR-978) (#32) (dabea42)

1.6.3 (2026-10-28)

Bug Fixes

  • statutes: preserve explicit pending effective status (#30) (e166014)

1.6.2 (2026-10-17)

Tests

  • release PR base 落後時應自動 update branch 再合併、等 check 拉長(JUR-768) (c0644c7)

1.6.1 (2026-10-17)

Bug Fixes

  • push 從同分支上一次成功掃描的 head 掃起,不漏掉被取消 run 的 commit(JUR-767) (550c869)

Tests

  • secret-scan 範圍抽成腳本並補行為測試,重現 main 連續 push 漏掃(JUR-767) (5f07d7e)

1.6.0 (2026-10-17)

Features

  • add sourced judgment search and full-text retrieval (eeac0cf)
  • add sourced judgment search and full-text retrieval (JUR-733) (95c6dfa)
  • add sourced regulation article lookup (8294bec)
  • add sourced regulation article lookup (JUR-735) (9e416ed)
  • route law page scraping through Firecrawl (141594b)

Bug Fixes

  • confirm missing articles from official structure (051ec88)
  • constrain official source boundaries (0d25062)
  • handle official source page variants (83ea310)
  • parse current official law lookup pages (41225eb)
  • preserve complete Bun lockfile (028d16a)
  • preserve judgment search limits and validate inputs (ab3f829)
  • preserve judgment search pagination and legacy IDs (63c23de)
  • reject empty law article structures (a1625a8)

Documentation

  • document judgment search and verify stdio contract (8c4e3a8)

1.5.0 (2026-06-24)

Features

  • add automated version management system (2ed28e7)
  • ci: add CI workflow and update code review prompt (83b8e0e)
  • MCP spec compliance — isError, pure JSON responses, SDK 1.x, 7 tools (7abdb72)
  • migrate to TypeScript + Vitest + ESM (c6321d2)
  • v1.4.0 MCP spec compliance — security, protocol, schema fixes (6d7eb64)
  • v1.4.0 MCP spec compliance fixes (#1) (984c011)
  • 刪除 CLAUDE.md 文件,移除不再需要的文檔 (b7aea73)
  • 刪除設定檔 settings.local.json,更新 .gitignore 以排除 .claude 目錄 (8958aa0)
  • 擴充 Bash 命令至設定檔,新增會員授權 Token 取得功能,更新 README.md 環境變數說明 (f95f614)
  • 新增 .env.example 檔案,包含伺服器設定與帳號資訊;更新 mcp-client-example.js 以簡化錯誤處理;更新 package.json 增加 TypeScript 支援與測試覆蓋率腳本;在 index.js 中增加錯誤日誌;擴充 tools.js 以加入輸入驗證功能;新增 TypeScript 類型定義檔案 index.d.ts (ae81062)
  • 新增 Bash 命令至設定檔,擴充允許的操作列表,更新 README.md 以提供 MCP 客戶端配置範例 (01b5430)
  • 新增會員授權 Token 驗證至工具配置,更新 API 調用以支援授權 (3e27806)
  • 更新 .gitignore,新增 .mcp.json 檔案排除 (47c155f)
  • 更新 .gitignore,新增 CLAUDE.md 檔案排除 (7bd7c97)
  • 更新 CHANGELOG.md,新增 1.2.0 版本的功能與改進;更新 package.json 版本號至 1.2.0;在 README.md 中新增測試覆蓋率執行說明 (1afc80b)
  • 更新 CLAUDE.md,修正工具數量,新增會員授權 Token 功能說明 (6f468d6)
  • 更新 README.md,新增行為準則、授權條款及 MCP 使用教學文件 (e0e562f)
  • 更新伺服器版本至 1.2.2 (10d9562)
  • 更新工具配置以支援會員授權 Token,調整相關測試用例 (a8f05bd)
  • 更新版本號至 1.1.0,新增 CHANGELOG.md 檔案以記錄變更 (dc204a6)
  • 移除 index.js 中的授權資訊註解 (4aee235)
  • 移除多個檔案中的作者與版本註解,簡化文件內容 (417fc2d)
  • 移除自動更新版本號的腳本,簡化版本管理流程 (fdd58a7)
  • 隱藏 dotenv 輸出至控制台,優化錯誤處理,移除啟動訊息 (5cd0970)

Bug Fixes

  • openspec: address CodeRabbit review comments (b7956a2)
  • openspec: correct spec inaccuracies found in code review (7c1fde1)
  • review: address all 8 code review findings from PR #10 (a9edc20)
  • server: add safe serialization fallback + hasOwnProperty tool check (63f1e1b)
  • tools: strip content-type charset params before using as mimeType (f5523dc)
  • 修正 package.json 中的關鍵字大小寫,統一為小寫 (3be6178)
  • 無法成功取得【開放平台】的會員授權 Token (b36c14f)

Documentation

  • add CLAUDE.md with architecture overview and dev commands (44f9fa6)
  • add CLAUDE.md with architecture overview and dev commands (43a7574)
  • add copilot instructions (Node.js/CJS MCP template) (310193d)
  • add openspec config and full spec suite for all 7 MCP tools (2078cad)
  • add openspec config and full spec suite for all 7 MCP tools (39052fb)
  • openspec: archive typescript-migration + sync live specs to TypeScript source (93512db)
  • openspec: archive typescript-migration change + sync live specs to .ts (c21a2f3)
  • openspec: tighten routing spec to match content[0].type === 'resource' condition (851259e)
  • openspec: update design.md D3 to reflect moduleResolution: bundler (b15fabf)
  • update copilot-instructions with judicial-mcp specific context (cd67a1e)
  • 精簡 MCP_TUTORIAL.md 並修正工具分類 (2ba8780)

[1.2.1] - 2025-07-23

改進

  • 達成 100% 測試覆蓋率 (46 tests, 278 lines covered)
  • 移除未使用的 Express 伺服器相關檔案和依賴
  • 修正所有 oxlint 警告,提升程式碼品質
  • 增強 MCP 配置測試,包含所有 7 個工具的完整驗證
  • 新增工具架構安全性驗證 (additionalProperties: false)

移除

  • 刪除 server.js, start.js 及相關測試檔案
  • 清理 62 個未使用的 npm 套件依賴
  • 移除 Express.js 和 HTTP API 相關程式碼

[1.2.0] - 2025-07-22

新增

  • TypeScript 類型定義檔案 (types/index.d.ts)
  • 輸入驗證功能
  • 測試覆蓋率腳本 (test:coverage)
  • 環境變數範例檔案 (.env.example)

改進

  • 強化錯誤處理和日誌記錄
  • 新增 API 參數驗證機制

[1.1.1] - 2025-07-10

修復

  • 修正版本號不一致的問題
  • 同步所有文件中的版本資訊

改進

  • 優化專案版本管理流程

[1.1.0] - 2025-07-02

新增

  • 增加對 list_resources 工具的完整支持,允許用戶根據分類編號檢索資料源。
  • 完善 download_file 工具,支持分頁參數 top 和 skip。

改進

  • 優化 auth_token 工具的錯誤處理,提供更詳細的錯誤信息。
  • 更新測試覆蓋率,新增對 list_resources 和 download_file 工具的測試用例。
  • 改善 README.md 文檔,新增對新功能的使用說明。

修復

  • 修正 get_judgment 工具在處理無效裁判書 ID 時的錯誤回應。
  • 修復環境變數未正確加載時的潛在問題。

[1.0.0] - 2025-06-30

✨ 主要功能

  • 🏛️ 司法院裁判書 API - 取得裁判書授權、清單和內容
  • 📊 開放資料 API - 存取司法院開放資料平台
  • 🔍 分類資料 - 瀏覽主題分類和資料源
  • 📥 檔案下載 - 下載司法資料檔案
  • 🧪 完整測試 - Jest 測試覆蓋
  • 🔒 安全認證 - 支援 Token 基礎認證
  • 📖 完整文檔 - 詳細的 API 文檔和使用範例
  • ⚡ 高效能 - 基於 Express.js 框架,支援非同步處理