DocketBird MCP 服务器

此 MCP 服务器提供对 DocketBird 的法院案件数据和文档管理功能的访问。

要求

• Python 3.11
• uv 包管理器

设置

1. 如果尚未安装 uv，请安装：

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 创建并激活虚拟环境：

uv venv
source .venv/bin/activate  # 在 Unix/MacOS 上
# OR
.venv\Scripts\activate     # 在 Windows 上

3. 安装依赖项：

uv pip install .

4. 设置您的环境变量：

export DOCKETBIRD_API_KEY=your_api_key_here  # 在 Unix/MacOS 上
# OR
set DOCKETBIRD_API_KEY=your_api_key_here     # 在 Windows 上

运行服务器

使用以下命令运行服务器：

uv run docketbird_mcp.py

可用工具

服务器提供以下工具：

1. get_case_details: 获取有关案件的全面详细信息，包括所有文档
2. download_document_by_id: 通过其 DocketBird ID 下载特定文档
3. list_cases: 获取属于帐户的案件列表
4. list_courts_and_types: 获取所有可用法院和案件类型的综合列表

配置文件

确保这些文件与脚本位于同一目录中：

• courts.json: 包含有关所有可用法院的信息
• case_types.json: 包含有关不同类型案件的信息

MCP 服务器配置

MCP 服务器配置可以添加到以下位置之一，具体取决于您的 MCP 客户端：

• Cursor: ~/.cursor/mcp.json
• Claude in mac: ~/Library/Application Support/Claude/claude_desktop_config.json

1. 如果尚未安装 uv，请安装：

curl -LsSf https://astral.sh/uv/install.sh | sh

将以下配置添加到相应的文件：

{
  "mcpServers": {
    "docketbird-mcp": {
            "command": "uv",
            "args": [
                "run",
                "--directory",
                "PATH_TO_THE_SERVER/docketbird-mcp",
                "python",
                "docketbird_mcp.py"],
            "env": {
                "DOCKETBIRD_API_KEY": "YOUR_KEY"
            }
        }
}

部署

DocketBird MCP 服务器可以使用 Docker 和 GitHub Actions 部署到云服务器。 部署过程在 .github/workflows/deploy.yml 文件中定义。

Docker 部署

服务器使用 Docker 进行容器化。 您可以在本地构建和运行 Docker 镜像：

# Build for ARM architecture (M1/M2 Mac)
docker buildx build --platform linux/arm64 -t docketbird-mcp-arm:latest --load .

# Build for AMD architecture (standard servers)
docker buildx build --platform linux/amd64 -t docketbird-mcp:latest --load .

# Run locally
docker run -d \
  --name docketbird-mcp \
  --restart=always \
  -e DOCKETBIRD_API_KEY="your_api_key_here" \
  docketbird-mcp-arm:latest /app/start.sh

验证部署

要验证您的部署是否正常工作：

1. 检查容器是否正在运行：

docker ps | grep docketbird-mcp

2. 验证容器日志：

docker logs docketbird-mcp

日志应显示：

Starting DocketBird MCP server...
API Key set: your_...
Running python docketbird_mcp.py

3. 使用本 README 中的配置从您的 MCP 客户端测试连接。

如果容器未运行，您可以通过检查以下内容进行故障排除：

• Docker 镜像是否存在：docker images | grep docketbird
• 容器日志中的错误：docker logs docketbird-mcp
• 服务器日志：检查是否存在任何权限或网络问题

触发更新