MCP Organizze

MCP有机物

MCP服务器与Organizze财务管理器集成，与任何MCP客户端（Claude Desktop等）兼容。

本项目将 Organizze v2 API 暴露为 AI 工具，允许您创建交易、查询余额、目标等。

✨ 功能

• 账户列出、创建和详细说明银行账户。
• 交易创建（支出/收入）并列出动作。
• 信用卡列出并详细说明发票。
• 类别和目标：全面管理。

🚀 如何使用

先决条件

您需要您的 Organize 凭据：

• ORGANIZZE_EMAIL：请通过电子邮件取消登录。
• ORGANIZZE_API_KEY您的 API 密钥。

选项1：通过UVX（推荐）

如果你有 uv 安装，可以直接运行而不安装任何东西：

# Executa em modo STDIO (padrão para Claude Desktop)
ORGANIZZE_EMAIL=seu@email.com ORGANIZZE_API_KEY=sua_chave uvx mcp-organizze

为了整合到 克劳德桌面添加到您的配置文件：

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

选项 2：通过 Docker

Docker 映像默认以模式运行 流式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段的行动。