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