Skip to content

francesshenaiclass/legel-mcp

 
 

Repository files navigation

Taiwan Law MCP 台灣法規查詢 MCP 伺服器

一個優化的台灣法規查詢系統,提供高效的法規搜尋和條文查詢功能。

特色功能

🚀 優化特性

  • 參數化內容控制 - 減少 token 消耗
  • 精確法規代碼搜尋 - 快速取得法規 pcode
  • 可配置搜尋結果 - 自定義結果數量
  • 摘要模式支援 - 完整模式與摘要模式切換
  • 專門的法條代碼查詢 - 輕量級代碼查詢功能

📋 主要工具

  1. search_law - 搜尋法規名稱,取得基本資訊
  2. get_law_pcode - 快速取得法規代碼
  3. get_full_law - 取得完整法規條文(支援摘要模式)
  4. get_single_article - 查詢特定條文
  5. search_by_keyword - 關鍵字搜尋(可控制結果數量)
  6. validate_pcode - 驗證法規代碼有效性

安裝使用

使用 UVX(推薦)

# 直接運行
uvx taiwan-law-mcp

# 或者安裝後使用
uv tool install taiwan-law-mcp
taiwan-law-mcp

使用 pip

pip install taiwan-law-mcp
taiwan-law-mcp

開發模式

# 克隆倉庫
git clone <repository-url>
cd legel-mcp

# 安裝依賴
uv sync

# 運行伺服器
python src/taiwan_law_mcp/server.py

作為 Python 套件使用

from taiwan_law_mcp import LawClient

# 使用客戶端
with LawClient() as client:
    # 搜尋法規
    result = client.search_law("民法")
    print(result)

    # 取得法規代碼
    pcode = client.get_pcode("民法")
    print(f"民法代碼: {pcode}")

    # 取得完整法規(摘要模式)
    law = client.get_full_law(pcode="B0000001", summary_mode=True, max_articles=10)
    print(law)

    # 關鍵字搜尋
    search_result = client.search_keyword("契約", max_results=5, summary_only=True)
    print(search_result)

API 範例

搜尋法規

{
  "name": "search_law",
  "arguments": {
    "name": "民法",
    "max_suggestions": 5
  }
}

取得法規代碼

{
  "name": "get_law_pcode",
  "arguments": {
    "name": "民法"
  }
}

取得完整法規(摘要模式)

{
  "name": "get_full_law",
  "arguments": {
    "pcode": "B0000001",
    "summary_mode": true,
    "max_articles": 20
  }
}

關鍵字搜尋

{
  "name": "search_by_keyword",
  "arguments": {
    "keyword": "契約",
    "max_results": 10,
    "summary_only": true
  }
}

優化說明

Token 消耗優化

  1. 摘要模式 - 每條法規只顯示第一行內容
  2. 結果數量限制 - 可設定最大搜尋結果數量
  3. 精簡搜尋 - 移除冗長的介紹文字
  4. 參數化內容 - 根據需求調整返回內容詳細程度

搜尋改進

  1. 專門的 pcode 查詢 - 快速取得法規代碼
  2. 代碼驗證功能 - 驗證法規代碼有效性
  3. 更明確的搜尋結果 - 精確匹配 vs 多重匹配
  4. 可配置建議數量 - 自定義搜尋建議數量

技術規格

  • Python 版本: 3.8+
  • 主要依賴:
    • requests >= 2.28.0
    • beautifulsoup4 >= 4.11.0
    • mcp >= 1.0.0
    • lxml >= 4.9.0 (非 Windows)

開發

設置開發環境

# 使用 uv
uv sync --dev

# 運行測試
uv run pytest

# 代碼格式化
uv run black src tests
uv run ruff check src tests

建構套件

uv build

💡 使用教學

🗣️ 如何與AI對話?

不需要特殊指令,就像與朋友聊天一樣:

推薦說法(自然、直接):

  • 「我想了解民法第1條」
  • 「搜尋包含契約的法條」
  • 「公司設立需要什麼條件?」
  • 「勞工有什麼權利?」
  • 「房屋買賣要注意什麼法規?」

不需要這樣說(太技術性):

  • 「執行search_law工具查詢民法」
  • 「使用get_full_law功能取得B0000001」

🔄 如果AI沒有使用法律工具怎麼辦?

有時候AI可能不知道有法律查詢功能,您可以這樣提醒:

方法1:直接詢問功能

  • 「你有法律查詢工具嗎?」
  • 「可以幫我查詢台灣法規嗎?」

方法2:明確要求介紹

  • 「請介紹法規查詢功能」
  • 「我想了解你的法律查詢能力」

方法3:重新描述需求

  • 「我需要查詢台灣的法律條文」
  • 「幫我搜尋相關法規」

🎓 進階使用技巧

組合查詢:讓AI幫您做複雜分析

  • 「比較民法和商事法中關於契約的不同規定」
  • 「查詢所有與公司治理相關的法條並整理重點」

情境諮詢:描述實際狀況獲得建議

  • 「我是公司老闆,想了解員工管理的法律規定」
  • 「作為房東,我需要知道哪些法律責任?」

學習導向:請AI當您的法律老師

  • 「用簡單的話解釋這個條文」
  • 「這條法律在什麼情況下會用到?」
  • 「有沒有相關的案例可以參考?」

🔧 常見問題解決

❓ 問題:「我按照步驟做了,但Claude沒反應」

解決方法

  1. 確認Python已正確安裝(執行 python --version
  2. 確認已安裝必要套件(重新執行 pip install -r requirements.txt
  3. 檢查claude_desktop_config.json的檔案路徑是否正確
  4. 重新啟動Claude Desktop

❓ 問題:「AI查到的資訊不準確」

解決方法

  1. 使用更具體的法規名稱(例如:「中華民國民法」而不是「民法」)
  2. 嘗試用關鍵字搜尋找出相關法條
  3. 確認網路連線正常(需要連到政府網站)

❓ 問題:「程式執行時出現錯誤」

解決方法

  1. 執行測試程式:python test_mcp.py 看看哪個功能有問題
  2. 檢查是否有防火牆或防毒軟體阻擋
  3. 嘗試重新安裝套件:pip install -r requirements.txt --upgrade

❓ 問題:「我是Mac/Linux用戶,設定方式一樣嗎?」

Mac用戶

  • 設定檔位置:~/Library/Application Support/Claude/claude_desktop_config.json
  • 其他步驟相同

Linux用戶

  • 設定檔位置:~/.config/Claude/claude_desktop_config.json
  • 可能需要使用 python3 而非 python

🚀 未來發展計畫

🔄 即將推出的功能

📜 立法沿革查詢

目標:了解法條的修訂歷史和立法背景

  • 查詢條文的歷次修正內容
  • 了解修法的時間和原因
  • 追蹤法條演變過程

使用情境

  • 律師準備訴狀時,需要引用特定時期的法條版本
  • 學者研究法制變遷的歷史脈絡
  • 政府機關評估政策影響時的法規變遷分析

⚖️ 大法官解釋查詢

目標:整合大法官解釋與相關法條

  • 自動找出與查詢條文相關的大法官解釋
  • 提供解釋文的重點摘要
  • 分析解釋對法條適用的影響

使用情境

  • 法官審理案件時參考大法官見解
  • 律師撰寫法律意見書時引用權威解釋
  • 學生學習憲法和行政法時的重要參考

📋 裁判書查詢

目標:連結法條與實際判決案例

  • 搜尋引用特定法條的判決書
  • 分析法條在實務上的適用情況
  • 提供判決要旨和關鍵論述

使用情境

  • 律師研究類似案件的判決趨勢
  • 當事人了解自己案件的可能結果
  • 法學研究者分析司法實務見解

🌏 國際法規比較(日韓法律)

目標:提供跨國法制比較研究

  • 整合日本和韓國的相關法規
  • 比較台日韓三地法制的異同
  • 提供國際法制發展趨勢分析

使用情境

  • 跨國企業了解不同地區的法律要求
  • 政府機關參考他國立法例制訂政策
  • 學者進行比較法學研究

🎯 長期願景

成為台灣最完整的AI法律助手

  1. 覆蓋所有法律領域:從基本法規到專業法規
  2. 即時更新:法規修正後立即同步最新版本
  3. 智能分析:不只查法條,還能分析適用和影響
  4. 多語言支援:支援中、英、日、韓多種語言查詢
  5. 行動裝置優化:手機、平板都能便利使用

📞 需要幫助?

🆘 技術支援

  • 查看 USAGE_GUIDE.md 了解詳細使用方法
  • 執行 python test_mcp.py 檢測功能狀態
  • 問題回報:GitHub Issues

⚖️ 免責聲明

  • 本工具僅提供法條查詢功能,不提供法律建議
  • 查詢結果僅供參考,正式用途請以官方公布為準
  • 如需專業法律意見,請諮詢合格律師或相關專業人士
  • 本工具不保證查詢結果的完整性和即時性

📄 資料來源


🤝 貢獻與回饋

我們歡迎各界使用者的意見和建議:

法律專業人士

  • 提供實務使用經驗
  • 建議增加的功能
  • 回報查詢準確性問題

技術開發者

  • 程式碼優化建議
  • 新功能開發協作
  • 系統穩定性改善

一般使用者

  • 使用體驗反饋
  • 介面易用性建議
  • 功能需求提案

讓我們一起打造更好的法律查詢工具,讓法律知識更容易親近!


最後更新:2024年
版本:1.0.0
Made with ❤️ for Taiwan Legal Community

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 100.0%