MCPFinanceiro

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

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

🌐 Uso com Docker Compose

Build e up:
docker-compose build docker-compose up -d
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étodo	Rota	Operation ID	Descrição
POST	`/pessoas/`	`createPessoa`	Cria nova pessoa
GET	`/pessoas/`	`listPessoas`	Lista pessoas
GET	`/pessoas/{id}`	`getPessoaById`	Busca pessoa por ID
PATCH	`/pessoas/{id}`	`updatePessoa`	Atualiza campos da pessoa
DELETE	`/pessoas/{id}`	`deletePessoa`	Remove pessoa

📂 Migrações com Alembic

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

⚖️ Licença

MIT License © Adjunto Sistemas

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

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.

Related MCP Servers

MCP Calc Tools
nbiish
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
Ledger CLI MCP Server
minhyeoky
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
Supabase MCP Server
Quegenx
-
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
Beanquery MCP Server
vanto
-
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