Adfin Financial Management

🚀 配置Adfin工具与Claude Desktop集成

本项目旨在帮助你将Adfin工具集成到Claude Desktop中，实现一系列功能，如信用控制状态检查、发票创建和上传等。

🚀 快速开始

环境要求

• 你需要安装 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 下载并安装 Claude 桌面版。
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 发票。