金融管理集成服务

MCP Organizze是一个金融服务集成工具,通过API v2将Organizze财务管理器的功能暴露为AI工具,支持交易创建、余额查询、目标管理等操作。

  • by SamuelMoraesF
  • Python
  • 混合部署
  • 6 星标
  • 更新于
在 GitHub 查看 SamuelMoraesF/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段的行动。