MCP金融API

MCP金融API是一个基于FastAPI构建的CRUD API,用于管理人员信息,支持JWT认证。它使用SQLAlchemy和Alembic进行数据库操作,支持SQLite数据库,并提供了Swagger UI文档。该API与n8n的MCP客户端工具兼容,允许AI流程自动注册客户到数据库。

  • by j4mesmorais
  • 更新于
在 GitHub 查看 j4mesmorais/MCPFinanceiro

使用说明

基本能力

产品定位

MCP金融API是一个用于管理人员信息的CRUD API,支持JWT认证,适用于需要自动化客户注册和管理的场景。

核心功能

  • 人员信息的CRUD操作
  • JWT认证
  • 支持SQLite数据库
  • 使用SQLAlchemy和Alembic进行数据库操作
  • 提供Swagger UI文档
  • 与n8n的MCP客户端工具兼容

适用场景

  • 自动化客户注册
  • 人员信息管理
  • 与n8n集成实现自动化流程

工具列表

  • Swagger UI: 提供API文档和交互式测试界面
  • Alembic: 数据库迁移工具
  • n8n MCP Client Tool: 用于自动化流程集成

使用教程

使用依赖

  • Python 3.11+
  • pip
  • Docker & Docker Compose (可选)

安装教程

  1. 克隆仓库:
    git clone <SEU_REPO_URL>
    cd meu_projeto
    
  2. 创建并激活虚拟环境:
    python3 -m venv .venv
    source .venv/bin/activate  # Linux/macOS
    .venv\Scripts\activate.bat # Windows
    
  3. 安装依赖:
    pip install --upgrade pip
    pip install -r requirements.txt
    
  4. 配置.env文件:
    SECRET_KEY=uma_senha_supersecreta
    ALGORITHM=HS256
    ACCESS_TOKEN_EXPIRE_MINUTES=60
    DATABASE_URL=sqlite:///./mcp.db
    
  5. 启动服务器:
    uvicorn run:app --reload
    

调试方式

  1. 访问Swagger UI:

    • 打开浏览器访问http://localhost:8000/docs
    • 点击"Authorize"按钮,输入JWT令牌
    • 测试API端点
  2. 使用Docker Compose:

    docker-compose build
    docker-compose up -d
    

    访问https://mcpfinanceiro.adjunto.com.br或http://localhost:8000