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 发票。