Skip to main content
Glama

MCPFinanceiro

by j4mesmorais

MCP API

API de CRUD de Pessoas protegida por JWT, construída com FastAPI, SQLAlchemy e Alembic.

🚀 Visão Geral

  • Linguagem: Python 3.11
  • Framework: FastAPI
  • Banco de Dados: SQLite (mcp.db)
  • ORM: SQLAlchemy + Alembic
  • Documentação: Swagger UI (OpenAPI)
  • Autenticação: JWT (Bearer)
  • Servidor MCP: compatível com o MCP Client Tool do n8n, permitindo que fluxos de IA registrem clientes automaticamente no banco de dados via n8n

📂 Estrutura do Projeto

meu_projeto/ ├── .env # Variáveis de ambiente ├── requirements.txt # Dependências Python ├── Dockerfile # Imagem Docker ├── docker-compose.yml # Orquestração com Traefik ├── run.py # Entry-point do FastAPI └── app/ ├── config.py # Pydantic Settings ├── database.py # Engine, Session e Base ├── models/ # Modelos SQLAlchemy ├── schemas/ # Schemas Pydantic ├── crud/ # Funções de acesso ao BD └── api/ # Rotas e dependências de segurança

⚙️ Pré-requisitos

  • Python 3.11+
  • pip
  • Docker & Docker Compose (opcional para container)

🔧 Instalação Local

  1. Clone o repositório:
    git clone <SEU_REPO_URL> cd meu_projeto
  2. Crie e ative um virtualenv:
    python3 -m venv .venv source .venv/bin/activate # Linux/macOS .venv\Scripts\activate.bat # Windows
  3. Instale dependências:
    pip install --upgrade pip pip install -r requirements.txt
  4. Configure seu .env (exemplo em .env.example):
    SECRET_KEY=uma_senha_supersecreta ALGORITHM=HS256 ACCESS_TOKEN_EXPIRE_MINUTES=60 DATABASE_URL=sqlite:///./mcp.db
  5. Gere o banco e suba o servidor:
    uvicorn run:app --reload

🌐 Uso com Docker Compose

  1. Build e up:
    docker-compose build docker-compose up -d
  2. Acesse em https://mcpfinanceiro.adjunto.com.br ou http://localhost:8000.

📑 Documentação & Swagger UI

  • OpenAPI JSON: /openapi.json
  • Swagger UI: /docs
    • Clique em Authorize, cole apenas o JWT.
    • Depois faça chamadas às rotas de /pessoas.

🔐 Autenticação JWT

  • Esquema: Bearer JWT
  • Components/securitySchemes: bearerAuth
  • As operações usam Security(get_current_user) e global security no OpenAPI.

Geração de Token (externa)

Exemplo de geração manual:

python3 - << 'PYCODE' import jwt, datetime SECRET_KEY = "uma_senha_supersecreta" ALGORITHM = "HS256" payload = {"sub":"usuario", "exp": datetime.datetime.utcnow() + datetime.timedelta(hours=1)} print(jwt.encode(payload, SECRET_KEY, algorithm=ALGORITHM)) PYCODE

📝 Endpoints Principais

MétodoRotaOperation IDDescrição
POST/pessoas/createPessoaCria nova pessoa
GET/pessoas/listPessoasLista pessoas
GET/pessoas/{id}getPessoaByIdBusca pessoa por ID
PATCH/pessoas/{id}updatePessoaAtualiza campos da pessoa
DELETE/pessoas/{id}deletePessoaRemove pessoa

📂 Migrações com Alembic

  1. Inicializar repo:
    alembic init migrations
  2. Criar migration:
    alembic revision --autogenerate -m "Descrição"
  3. Aplicar:
    alembic upgrade head

⚖️ Licença

MIT License © Adjunto Sistemas

-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A server for managing financial accounting entries that provides utilities for database access using SQLAlchemy with environment-based configuration.

  1. 🚀 Visão Geral
    1. 📂 Estrutura do Projeto
      1. ⚙️ Pré-requisitos
        1. 🔧 Instalação Local
          1. 🌐 Uso com Docker Compose
            1. 📑 Documentação & Swagger UI
              1. 🔐 Autenticação JWT
                1. Geração de Token (externa)
              2. 📝 Endpoints Principais
                1. 📂 Migrações com Alembic
                  1. ⚖️ Licença

                    Related MCP Servers

                    • A
                      security
                      F
                      license
                      A
                      quality
                      A server that provides advanced mathematical and financial calculation capabilities for AI code assistants, enabling them to perform complex calculations like symbolic calculus, numerical methods, and financial analysis without implementing algorithms directly.
                      Last updated -
                      18
                      1
                      JavaScript
                    • A
                      security
                      F
                      license
                      A
                      quality
                      A Model Context Protocol server that allows AI assistants to query and analyze financial data through Ledger CLI, enabling tasks like financial reporting, budget analysis, and accounting.
                      Last updated -
                      9
                      21
                      Python
                      • Apple
                      • Linux
                    • -
                      security
                      F
                      license
                      -
                      quality
                      A powerful server that provides administrative control over Supabase PostgreSQL databases through Cursor's Composer and Codeium's Cascade, enabling database management with features for tables, records, schema modifications, and more.
                      Last updated -
                      9
                      10
                      TypeScript
                      • Apple
                      • Linux
                    • -
                      security
                      A
                      license
                      -
                      quality
                      An experimental server implementing the Model Context Protocol to allow AI assistants to query and analyze financial data stored in Beancount ledger files using the Beancount Query Language.
                      Last updated -
                      2
                      Python
                      MIT License

                    View all related MCP servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/j4mesmorais/MCPFinanceiro'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server