wave_mcp - 集成Claude與Wave會計軟件，支持即時API，助力費用跟蹤與交易創建

探索

Wave MCP

一個集成Claude與Wave會計軟件的MCP服務器，用於自動化費用跟蹤和收入交易創建，支持多企業管理、供應商/客戶搜索和即時API連接。

金融人工智能聊天機器人 #會計自動化 #費用跟蹤 #多企業管理 #API集成 .Python

評分 : 2分

下載量 : 0

更新時間 : 2025-07-24

打開站點

什麼是Wave Accounting MCP服務器？

Wave Accounting MCP服務器是一個連接Claude和Wave Accounting的工具，能夠自動創建費用和收入交易。它通過Model Context Protocol (MCP)實現與Claude的交互。

如何使用Wave Accounting MCP服務器？

通過配置Claude Desktop，將Wave Accounting MCP服務器添加到應用程序中。然後可以使用自然語言指令來管理費用、收入和業務設置。

適用場景

適用於需要自動化處理財務記錄的企業和個人用戶，特別是那些希望利用AI進行日常會計工作的用戶。

主要功能

從收據創建費用

自動從收據文本中提取信息並創建費用記錄。

創建收入交易

根據支付數據自動生成收入交易。

多業務支持

輕鬆管理多個Wave賬戶，切換不同業務。

供應商和客戶搜索

查找現有的供應商和客戶信息。

賬戶管理

列出和分類交易，使用正確的賬戶進行記錄。

即時集成

直接連接到Wave的GraphQL API，確保數據同步。

優勢

自動化費用和收入記錄，節省時間。

支持多業務管理，適合多賬戶用戶。

與Claude無縫集成，提供自然語言交互體驗。

即時更新Wave的數據，確保準確性。

侷限性

無法上傳收據圖片或PDF文件。

Wave API有速率限制，最多同時請求2個。

OAuth2訪問令牌可能過期，需要定期刷新。

供應商和客戶必須在Wave中手動創建。

如何使用

克隆倉庫

從GitHub克隆Wave Accounting MCP服務器的代碼。

安裝依賴項

進入項目目錄並安裝所需的Python庫。

配置環境變量

創建.env文件並添加Wave OAuth2訪問令牌。

配置Claude Desktop

在Claude Desktop的配置文件中添加Wave Accounting MCP服務器。

重啟Claude Desktop

保存配置後重啟Claude Desktop以使更改生效。

使用案例

創建費用

輸入收據文本，系統會自動提取信息並創建費用記錄。

創建收入

輸入支付信息，系統會生成對應的收入交易。

切換業務

輸入業務名稱或ID，切換當前使用的Wave賬戶。

常見問題

如何獲取Wave OAuth2訪問令牌？

為什麼我的Wave客戶端未初始化？

如何解決‘沒有選擇業務’的問題？

為什麼MCP服務器在Claude中不可用？

🚀 Wave Accounting MCP Server

Wave Accounting MCP Server 是一個模型上下文協議（MCP）服務器，它將 Claude 與 Wave Accounting 集成，實現了費用跟蹤和收入交易創建的自動化。

🚀 快速開始

Wave Accounting MCP Server 可將 Claude 與 Wave Accounting 集成，實現費用跟蹤和收入交易創建的自動化。你可以按照以下步驟進行安裝和配置：

前提條件

Python 3.8 或更高版本
具有 API 訪問權限的 Wave 商業賬戶
Claude 桌面應用程序
Wave OAuth2 訪問令牌

安裝步驟

克隆倉庫：

git clone https://github.com/yourusername/wave_mcp.git
cd wave_mcp

安裝依賴項：

pip install -r requirements.txt

創建一個 .env 文件：

WAVE_ACCESS_TOKEN=your_wave_oauth2_access_token_here

獲取 Wave 訪問令牌

登錄到你的 Wave 賬戶
導航到設置 → API 訪問
創建一個新的 OAuth2 應用程序
生成具有適當權限的 OAuth2 不記名訪問令牌

⚠️ 重要提示

Wave API 訪問可能需要審批，請查看 Wave 當前的開發者計劃狀態。

配置

Claude 桌面設置

將服務器添加到你的 Claude 桌面配置中：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "wave-accounting": {
      "command": "python",
      "args": ["/absolute/path/to/wave_mcp/mcp_server.py"],
      "env": {
        "WAVE_ACCESS_TOKEN": "your_wave_oauth2_access_token_here"
      }
    }
  }
}

保存配置後，重啟 Claude 桌面應用程序。

✨ 主要特性

📸 從收據創建費用：自動從收據文本中提取並創建費用
💰 創建收入交易：根據付款數據創建收入交易
🏢 多企業支持：無縫管理多個 Wave 企業
🔍 供應商和客戶搜索：查找現有的供應商和客戶
📊 賬戶管理：使用適當的賬戶列出和分類交易
🔄 實時集成：直接連接到 Wave 的 GraphQL API

💻 使用示例

基礎用法

從收據創建費用

I have a receipt from Office Depot for $45.99 dated March 15, 2024. 
It's for office supplies - printer paper and pens.

從付款創建收入

Received payment of $1,500 from ABC Company on March 20, 2024 
for consulting services invoice #1234.

列出可用賬戶

Show me my expense accounts in Wave.

設置活躍企業（多企業賬戶）

List my Wave businesses and set the active one.

📚 詳細文檔

可用的 MCP 工具

費用管理

create_expense_from_receipt：從收據文本創建費用
search_vendor：搜索現有的供應商
get_expense_accounts：列出可用的費用賬戶

收入管理

create_income_from_payment：創建收入交易
search_customer：搜索現有的客戶
get_income_accounts：列出可用的收入賬戶

企業管理

set_business：設置活躍企業
list_businesses：列出所有可用的企業

調試

debug_accounts：列出所有賬戶及其類型和子類型，用於故障排除

重要注意事項

供應商和客戶管理

供應商和客戶必須在 Wave 的網頁界面中手動創建
API 支持搜索現有的供應商/客戶，但不支持創建新的供應商/客戶
可以在沒有供應商/客戶的情況下創建交易，並在以後進行關聯

限制

Wave API 不支持附加收據圖像/PDF
最多支持 2 個併發 API 請求（Wave 速率限制）
OAuth2 令牌可能會過期，需要刷新

🔧 技術細節

開發

運行測試

# Currently no test suite - testing via Claude Desktop integration
python mcp_server.py

項目結構

wave_mcp/
├── mcp_server.py          # Main MCP server implementation
├── requirements.txt       # Python dependencies
├── README.md             # This file
├── LICENSE               # MIT License
├── CLAUDE.md             # Claude-specific instructions
├── .env                  # Your API credentials (not tracked)
└── docs/
    └── wave_api_reference.md  # Wave API documentation