Adfin Financial Management

🚀 uvとClaude Desktopのセットアップ

このプロジェクトでは、uvをインストールし、Claude Desktopを設定することで、Adfin APIツールを利用できるようになります。以下に手順を説明します。

🚀 クイックスタート

前提条件

• Python 3.10 以上のバージョンが必要です。

📦 インストール

1. uvのインストール

• MacOS/Linux:

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

• Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Claude デスクトップ版の設定

1. Claude Desktop をダウンロードします。
2. Claudeを開き、「設定」>「開発者」>「編集設定」に移動します。
3. claude_desktop_config.json ファイルを以下のように編集します。

{
  "mcpServers": {
    "Adfin": {
      "command": "<home_path>/.local/bin/uv",
      "args": [
        "--directory",
        "<absolute_path_to_adfin_mcp_folder>",
        "run",
        "main_adfin_mcp.py"
      ],
      "env": {
        "ADFIN_EMAIL": "<email>",
        "ADFIN_PASSWORD": "<password>"
      }
    },
    "filesystem": {
      "command": "<home_path>/.local/bin/uv",
      "args": [
        "--directory",
        "<absolute_path_to_adfin_mcp_folder>",
        "run",
        "filesystem.py"
      ]
    }
  }
}

4. Claude Desktopを再起動します。

初めてこれらの設定を適用したClaude Desktopを開くと、必要なパッケージのインストールと最新のAdfin APIドキュメントのダウンロードに10 - 20秒かかる場合があります。Claude Desktopを起動するたびに、最新のAdfin APIツールがAIアシスタントに提供されます。

💻 使用例

基本的な使用法

Claude Desktopを起動し、AIアシスタントに以下のようなリクエストを送信することができます。

信用管理状態のリクエスト

信用管理状態のチェックをしてください。

新しい請求書の作成

Abc Defに対して、1週間後に期限が切れる60ポンドの請求書を作成してください。彼のメールアドレスは abc.def@example.com です。

フォルダから複数の請求書をアップロードするようにアシスタントに依頼する

デスクトップの請求書フォルダからすべてのPDF請求書をアップロードしてください。