Droitfrancaismcp

🚀 法國法律MCP服務器

本項目旨在探索通過 模型上下文協議（Model Context Protocol，MCP） 在 Claude Desktop 中集成工具。

此項目是一次實驗與驗證，旨在瞭解工具編排如何提升語言模型（LLM）在處理技術數據時的可靠性、相關性和效率。

在此框架下，項目著重於獲取來自官方來源的可靠法律數據。

這裡開發的MCP服務器提供了一個統一接口，用於查詢法國法律的公共API，特別是：

• 立法網（Légifrance）——用於查詢立法、法典、法律和法令
• 司法自由（JudiLibre）——用於查詢判例法和司法判決

藉助該服務器，用戶可以搜索和查閱：

• 📖 法國法律法規（民法典、刑法典、勞動法等）
• 📜 法律、法令、政令和行政命令
• ⚖️ 所有法國司法管轄區的判例法
• 📰 《法蘭西共和國政府公報》（JORF）
• 🤝 集體協議
• 🏛️ 國務委員會、最高法院和法庭的判決

🚀 快速開始

本項目旨在通過MCP協議在Claude Desktop中集成工具，以提升語言模型處理法律數據的能力。以下是使用該項目的快速步驟：

1. 確保滿足先決條件。
2. 完成安裝和配置。
3. 啟動服務器並開始使用，參考使用示例。

✨ 主要特性

🔍 立法網搜索

• 高級搜索：可在所有法國法律庫中進行高級搜索。
• 強大的過濾功能：可按性質、日期、司法管轄區、部門等進行過濾。
• 條款查詢：可查看完整文本及詳細元數據。
• 多庫支持：支持法典、法律、政府公報、判例法、集體協議等。

⚖️ 司法自由搜索

• 判例法搜索：可在所有法國司法管轄區搜索判例法。
• 上下文過濾：可按司法管轄區、分庭、地點、解決方案、主題等進行過濾。
• 完整判決文本：包含結構化區域的完整判決文本。
• 完整分類法：可訪問有效值列表（分庭、組成、主題等）。

🛠️ 技術特性

• 安全的OAuth 2.0認證
• 自動令牌管理
• 詳細的日誌記錄：便於調試
• 沙盒和生產模式
• 參數驗證
• 錯誤處理

📦 安裝指南

1. 克隆倉庫

git clone https://github.com/jmtanguy/DroitFrancaisMCP.git
cd DroitFrancaisMCP

或者下載項目的ZIP文件。

2. 安裝

執行與您操作系統對應的安裝腳本：

• Windows：install.ps1
• macOS / Linux：install.sh

這些腳本將自動執行以下操作：

• 📦 創建Python虛擬環境
• 🔽 安裝所有必要的依賴項
• ⚙️ 配置Claude Desktop客戶端以使用此MCP服務器

⚙️ 配置

1. 創建環境文件

# 複製示例文件
cp .env.example .env

2. 填寫PISTE憑證

編輯 .env 文件，填入真實值：

# PISTE生產環境API憑證
PISTE_CLIENT_ID=您的生產環境客戶端ID
PISTE_CLIENT_SECRET=您的生產環境客戶端密鑰

# PISTE沙盒環境API憑證（可選，用於測試）
PISTE_SANDBOX_CLIENT_ID=您的沙盒環境客戶端ID
PISTE_SANDBOX_CLIENT_SECRET=您的沙盒環境客戶端密鑰

⚠️ 重要提示

.env 文件包含您的機密信息，切勿提交到Git倉庫！

3. 配置MCP客戶端

配置Claude Desktop

要在Claude Desktop中使用服務器，請檢查以下配置文件：

• macOS/Linux：~/.config/claude-desktop/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "droit-francais": {
      "command": "/絕對路徑/到/DroitFrancaisMCP/.venv/bin/python3",
      "args": ["/絕對路徑/到/DroitFrancaisMCP/droit_francais_MCP.py"]
    }
  }
}

💡 使用建議

請將 /絕對路徑/到/ 替換為您項目目錄的完整路徑。

配置Cursor

要在Cursor中使用服務器，請在MCP配置文件（通常為 ~/.cursor/mcp.json 或在Cursor設置中）添加以下配置：

{
  "mcpServers": {
    "DroitFrancaisMCP": {
      "command": "<DroitFrancaisMCP項目路徑>/.venv/bin/python3",
      "args": [
        "-u",
        "<DroitFrancaisMCP項目路徑>/droit_francais_MCP.py"
      ],
      "cwd": "<DroitFrancaisMCP項目路徑>",
      "env": {
        "PYTHONPATH": "<DroitFrancaisMCP項目路徑>",
        "PYTHONUNBUFFERED": "1",
        "PYTHONIOENCODING": "utf-8"
      },
      "envFile": "<環境文件路徑>",
      "description": "用於法國法律研究的MCP服務器（立法網、司法自由）",
      "enabled": true
    }
  }
}

💡 使用建議

• 請將 <DroitFrancaisMCP項目路徑> 替換為您的 DroitFrancaisMCP 項目目錄的完整路徑。
• 請將 <環境文件路徑> 替換為包含PISTE憑證的 .env 文件的完整路徑。

💻 使用示例

基礎用法

在Claude Desktop或Cursor中，您可以嘗試以下示例：

幫我查找民法典中關於婚姻的條款

最高法院近期關於嚴重過錯解僱的判決有哪些？

請提供2021年8月24日第2021 - 1109號關於尊重共和國原則的法律全文

Claude或Cursor將自動識別合適的MCP工具，查詢官方來源並展示相應結果。

🛠️ 可用工具

立法網

司法自由

🏗️ 架構

DroitFrancaisMCP/
├── droit_francais_MCP.py          # 主MCP服務器
├── api_legifrance.py              # 立法網API客戶端
├── api_legifrance_search_input.py # 立法網查詢模型
├── api_legifrance_search_output.py# 立法網響應模型
├── api_judilibre.py               # 司法自由API客戶端
├── test_api_legifrance.py         # 立法網測試
├── test_api_judilibre.py          # 司法自由測試
├── requirements.txt               # Python依賴項
├── .env.example                   # 配置模板
└── README.md                      # 文檔

主要組件

• droit_francais_MCP.py：通過FastMCP暴露工具的MCP服務器
• api_legifrance.py：帶有OAuth認證的立法網API客戶端
• api_judilibre.py：帶有令牌管理的司法自由API客戶端
• 測試：功能驗證腳本

🧪 測試

測試立法網API

python3 test_api_legifrance.py

測試司法自由API

python3 test_api_judilibre.py

使用pytest測試

pytest test_api_legifrance.py -v
pytest test_api_judilibre.py -v

📄 許可證

本項目採用MIT許可證。詳情請參閱 LICENSE 文件。

🔗 有用鏈接

• PISTE官方網站 —— API訪問申請
• 模型上下文協議 —— MCP規範
• Claude Desktop —— Claude應用程序
• Cursor —— 支持MCP的代碼編輯器

🤖 人工智能輔助開發

本項目在人工智能工具的輔助下開發：

• Claude（Anthropic）—— 開發助手和代碼生成工具
• GitHub Copilot —— 代碼自動補全工具

使用這些工具加速了開發進程，同時保證了代碼質量和文檔完整性。所有生成的內容都經過了審查、驗證，並根據項目的特定需求進行了調整。

💡 使用建議

此說明有助於貢獻者和用戶瞭解項目的創建背景。

👤 作者

Jean - Michel Tanguy