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 镜像默认以 Streamable HTTP (SSE) 模式在端口 8000 上运行，适合远程使用或在服务上运行。

使用 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。