Wave MCP

🚀 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 访问令牌

安装步骤

1. 克隆仓库：

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

2. 安装依赖项：

pip install -r requirements.txt

3. 创建一个 .env 文件：

WAVE_ACCESS_TOKEN=your_wave_oauth2_access_token_here

获取 Wave 访问令牌

1. 登录到你的 Wave 账户
2. 导航到 设置 → API 访问
3. 创建一个新的 OAuth2 应用程序
4. 生成具有适当权限的 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

故障排除

"Wave client not initialized"

• 验证你的 WAVE_ACCESS_TOKEN 是否正确设置
• 检查令牌是否具有有效的权限

"No business selected"

• 使用 list_businesses 工具查看可用的企业
• 使用 set_business 设置活跃企业

MCP Server Not Available in Claude

• 确保 claude_desktop_config.json 中的路径是绝对路径
• 验证 Python 和所有依赖项是否已安装
• 重启 Claude 桌面应用程序

📄 许可证

本项目采用 MIT 许可证，请参阅 LICENSE 文件以获取详细信息。

致谢

• 为与 Claude Desktop 配合使用而构建
• 与 Wave Accounting 集成
• 使用 Model Context Protocol

安全

• 切勿提交你的 .env 文件或 API 密钥
• 对所有敏感数据使用环境变量
• 定期轮换你的 API 令牌
• 遵循 Wave 的安全最佳实践