🚀 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
验证部署
- 检查容器运行状态：
docker ps | grep docketbird-mcp - 查看日志：
docker logs docketbird-mcp
💻 使用示例
DocketBird 代理原型
功能特点
- 提供交互式命令行界面
- 支持自然语言查询案件信息
- 连接部署好的 DocketBird MCP 服务器
设置与运行
- 确保已设置 OpenAI API 密钥：
export OPENAI_API_KEY=your_openai_api_key_here # Unix/MacOS set OPENAI_API_KEY=your_openai_api_key_here # Windows - 运行代理程序：
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