Organizze

MCP Organizze

Organizze の財務管理ツールと連携する MCP サーバーです。任意の MCP クライアント（Claude Desktop など）と互換性があります。

このプロジェクトでは、Organizze の API v2 を AI ツールとして公開し、取引の作成、残高や目標の確認などを行えます。

✨ 機能

• 口座：銀行口座の一覧表示、作成、詳細表示。
• 取引：支出や収入の作成、取引履歴の一覧表示。
• クレジットカード：請求書の一覧表示、詳細表示。
• カテゴリーと目標：包括的な管理。

🚀 使用方法

前提条件

Organizze の認証情報が必要です。

• ORGANIZZE_EMAIL：ログイン用のメールアドレス。
• ORGANIZZE_API_KEY：API キー。

オプション 1：UVX 経由（推奨）

uv がインストールされていれば、何もインストールせずに直接実行できます。

# Executa em modo STDIO (padrão para Claude Desktop)
[email protected] ORGANIZZE_API_KEY=sua_chave uvx mcp-organizze

Claude Desktop と連携するには、設定ファイルに次の内容を追加してください。

{
  "mcpServers": {
    "organizze": {
      "command": "uvx",
      "args": ["mcp-organizze"],
      "env": {
        "ORGANIZZE_EMAIL": "seu_email",
        "ORGANIZZE_API_KEY": "sua_chave_api"
      }
    }
  }
}

オプション 2：Docker 経由

Docker イメージは、デフォルトでポート 8000 上の Streamable HTTP（SSE） モードで実行されます。リモートでの使用やサーバーでの使用に適しています。

SSE で実行（ポート 8000）：

docker run -p 8000:8000 \
  -e ORGANIZZE_EMAIL=seu_email \
  -e ORGANIZZE_API_KEY=sua_chave \
  mcp-organizze

STDIO で実行（インタラクティブ）：

docker run -i \
  -e ORGANIZZE_EMAIL=seu_email \
  -e ORGANIZZE_API_KEY=sua_chave \
  mcp-organizze --transport stdio

オプション 3：ローカルインストール（Pip/UV）

リポジトリをクローンしてインストールします。

uv pip install .
# ou
pip install .

サーバーを実行します。

python -m mcp_organizze

🛠 開発と公開

プロジェクト構成

• src/mcp_organizze：パッケージのソースコード。
• pyproject.toml：ビルドと依存関係の設定。
• Dockerfile：コンテナ化の設定。
• .github/workflows：CI/CD 用の Actions。