Wave_mcp

金融 Python

🚀 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

故障排除

"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 的安全最佳实践

0 条评论
分类：金融