MCP Server Adfin

🚀 基於Claude桌面應用的Adfin工具使用指南

本項目旨在幫助用戶在Claude桌面應用中集成並使用Adfin工具，實現如請求信用控制狀態、創建新發票等功能。通過簡單的配置和操作，用戶可以讓AI助手高效地處理相關業務。

🚀 快速開始

環境要求

要求使用 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",
        "<絕對路徑到adfin_mcp文件夾>",
        "運行",
        "main_adfin_mcp.py"
      ],
      "env": {
        "ADFIN_EMAIL": "<郵箱>",
        "ADFIN_PASSWORD": "<密碼>"
      }
    },
    "filesystem": {
      "command": "<home_path>/.local/bin/uv",
      "args": [
        "--directory",
        "<絕對路徑到adfin_mcp文件夾>",
        "運行",
        "filesystem.py"
      ]
    }
  }
}

4. 重新啟動 Claude 桌面應用。

⚠️ 重要提示

首次打開 Claude 桌面應用時，可能需要 10 - 20 秒才能顯示 Adfin 工具，因為需要安裝所需的包並下載最新的 Adfin API 文檔。

💡 使用建議

每次啟動 Claude 桌面應用時，最新的 Adfin API 工具都會提供給您的 AI 助手，可充分利用其功能提高工作效率。

第三步：啟動 Claude 桌面應用，並讓您的助手幫助您

💻 使用示例

基礎用法

以下是一些與AI助手交互的基礎示例：

• 請求信用控制狀態

給我一份信用控制狀態報告。

• 創建新發票

為 60 英鎊的發票生成一張，客戶是艾博·戴夫，到期時間為一週後。他的郵箱地址是 abc.def@example.com。

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

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