Adfin Financial Management

🚀 項目使用說明

本項目可幫助你配置Claude桌面版與Adfin工具，實現相關功能的調用，如信用控制狀態檢查、發票創建與上傳等。

🚀 快速開始

環境要求

要求使用 Python 3.10 或更高版本。

📦 安裝指南

安裝 uv

• MacOS/Linux：執行以下命令

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

• Windows：在 PowerShell 中執行以下命令

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

配置 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 可能需要 10 - 20 秒才能顯示 Adfin 工具，因為需要安裝所需的包並下載最新的 Adfin API 文檔。

💡 使用建議

每次啟動 Claude Desktop 時，最新的 Adfin API 工具都會提供給您的 AI 助手。

💻 使用示例

基礎用法

啟動 Claude Desktop 後，你可以讓助手幫助你完成各種任務，以下是一些示例：

• 請求信用控制狀態

給我一個信用控制狀態檢查。

• 創建新發票

為 Abc Def 創建一張 60 英鎊的發票，該發票在一個星期後到期。他的郵箱是 abc.def@example.com。

• 讓助手從您的文件夾中上傳多個發票

從我桌面的發票文件夾中上傳所有 PDF 發票。