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