Docketbird MCP

🚀 DocketBird MCP サーバー

DocketBird MCP サーバーは、案件情報の管理や検索を効率的に行うためのサーバーです。Python をベースに構築され、様々な機能を提供します。

🚀 クイックスタート

📦 インストール

インストール要件

• 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