taiwan-law-mcp 0.2.1

台灣法規查詢 MCP 伺服器 - 優化版本

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