Docketbird MCP

🚀 DocketBird MCP 服務器

DocketBird MCP 服務器是一個強大的案件信息管理工具，可用於案件信息查詢、文檔管理等。它支持多種安裝和部署方式，能滿足不同用戶的需求。

🚀 快速開始

安裝要求

• Python 3.11 或更高版本
• uv 包管理器

安裝步驟

安裝 uv 包管理器

運行以下命令安裝 uv：

curl -L https://github.com/uv-algo/uv/archive/v2.0.0.tar.gz | tar xz && cd uv-2.0.0 && make install

創建和激活虛擬環境（推薦）

• Unix/MacOS 系統 創建並激活虛擬環境：

python -m venv venv && source venv/bin/activate

• Windows 系統 創建並激活虛擬環境：

python -m venv venv && .\venv\Scripts\activate

安裝依賴項

使用以下命令安裝項目依賴項：

uv pip install .

設置環境變量

設置 DOCKETBIRD_API_KEY 環境變量：

export DOCKETBIRD_API_KEY=your_api_key_here  # Unix/MacOS
set DOCKETBIRD_API_KEY=your_api_key_here     # Windows

運行服務器

• 標準輸出（stdio）模式 運行以下命令啟動服務器：

python docketbird_mcp.py

• 流數據傳輸（SSE）模式 運行以下命令啟動服務器：

python docketbird_mcp.py --synchronous

✨ 主要特性

功能模塊

案件信息查詢

• get_case_details：獲取案件詳細信息。
• list_documents：列出案件中的文檔。

文檔管理

• retrieve_document：檢索特定文檔。
• search_content：在文檔內容中進行搜索。

配置文件

• courts.json：定義了支持的法院信息。
• case_types.json：定義了案件類型分類。

MCP 服務器配置

通用配置示例

{
  "servers": [
    {
      "url": "http://165.227.221.151:8040",
      "api_key": "your_api_key_here"
    }
  ]
}

Cursor 配置示例

{
  "docket_bird_url": "http://localhost:8000",
  "api_key": "your_api_key_here"
}

Docker 部署說明

構建 Docker 鏡像

運行以下命令構建鏡像：

docker build -t docketbird_mcp .

啟動容器

• ARM 架構

docker run --name docketbird-mcp-arm \
  -e DOCKETBIRD_API_KEY=your_api_key_here \
  -d docketbird_mcp:arm

• AMD64 架構

docker run --name docketbird-mcp-amd64 \
  -e DOCKETBIRD_API_KEY=your_api_key_here \
  -d docketbird_mcp:x86

驗證部署

1. 檢查容器運行狀態：

   docker ps | grep docketbird-mcp
   

2. 查看日誌：

   docker logs docketbird-mcp
   

💻 使用示例

DocketBird 代理原型

功能特點

• 提供交互式命令行界面
• 支持自然語言查詢案件信息
• 連接部署好的 DocketBird MCP 服務器

設置與運行

1. 確保已設置 OpenAI API 密鑰：

   export OPENAI_API_KEY=your_openai_api_key_here  # Unix/MacOS
   set OPENAI_API_KEY=your_openai_api_key_here     # Windows
   

2. 運行代理程序：

   cd agents
   python db_agent_prototype.py
   

示例查詢

• "請提供案件 txnd-3:2007-cv-01697 的詳細信息"
• "此案件中有哪些可用文檔？"
• "這個案件的最新文件是在什麼時候提交的？"

依賴項要求

• OpenAI API 密鑰（用於 GPT - 4.1 模型）
• 網絡連接（用於訪問部署好的 MCP 服務器）
• Python 依賴：pydantic_ai, termcolor, python - dotenv

⚠️ 重要提示

此代理原型已連接到以下 MCP 服務器：

http://165.227.221.151:8040