MCP Server for Veryfi Document Processing

Veryfi ドキュメント処理用 MCP サーバー

概要

ドキュメントからデータを抽出するために Veryfi と連携する、Model Context Protocol（MCP）サーバーの実装です。

セットアップ

Veryfi のユーザー名、client_id、api key を取得する

https://app.veryfi.com にログインし、https://app.veryfi.com/api/settings/keys/ に移動します。

Claude Desktop を使用する

claude_desktop_config.json を変更して、次の内容を追加します。

ここでは環境変数を設定しないでください。MCP サーバーが使用する環境変数と、ほかのコードが使用する環境変数が異なると、混乱の原因になります。

代わりに、実行環境で設定するか、.env ファイルを使用してください。

{
    "mcpServers": {
        "veryfi": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/mcp-server",
                "run",
                "src/server.py"
            ],
            "env": {}
        }
    }
}

開発環境のセットアップ

ローカル開発

1. リポジトリをクローンします

2. 次の変数を含む .env ファイルを作成します。

   VERYFI_CLIENT_ID="veryfi-client-id-goes-here_client_id"
   VERYFI_USERNAME="veryfi-username-goes-here"
   VERYFI_API_KEY="veryfi-api-key-goes-here"
   

または、実行環境で環境変数を設定できます。たとえば Mac では、 ~/.zprofile に次の内容を追加します。

export VERYFI_CLIENT_ID="veryfi-client-id-goes-here_client_id"
export VERYFI_USERNAME="veryfi-username-goes-here"
export VERYFI_API_KEY="veryfi-api-key-goes-here"

3. 依存関係をインストールします。

   pip install uv
   uv sync
   

4. サーバーをローカルで実行します。

   uv run mcp dev src/server.py
   

テスト

次のコマンドでテストスイートを実行します。

uv run pytest