Wave MCP

🚀 Wave Accounting MCP Server

このサーバーは、Model Context Protocol (MCP) を使用して、Claude と Wave Accounting を統合し、経費の追跡と収入取引の作成を自動化します。

✨ 主な機能

• 📸 領収書からの経費作成：領収書のテキストから自動的に経費を抽出して作成します。
• 💰 支払データからの収入取引作成：支払データから収入取引を作成します。
• 🏢 複数事業のサポート：複数の Wave 事業をシームレスに管理できます。
• 🔍 取引先と顧客の検索：既存の取引先と顧客を検索できます。
• 📊 勘定科目管理：適切な勘定科目で取引を一覧表示し、分類します。
• 🔄 リアルタイム統合：Wave の GraphQL API への直接接続をサポートします。

📦 インストール

前提条件

• Python 3.8 以上
• API アクセス権を持つ Wave ビジネスアカウント
• Claude Desktop アプリケーション
• 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 Desktop の設定

Claude Desktop の設定にサーバーを追加します。

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 Desktop を再起動します。

💻 使用例

基本的な使用法

領収書からの経費作成

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 Desktop を再起動します。

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。

🙏 謝辞

• Claude Desktop との連携をサポートしています。
• Wave Accounting と統合しています。
• Model Context Protocol を使用しています。

🔒 セキュリティ

• .env ファイルや API キーをコミットしないでください。
• すべての機密データに環境変数を使用してください。
• API トークンを定期的に更新してください。
• Wave のセキュリティベストプラクティスに従ってください。