convez.ai
MCP ServerFinanceiroIntermediário
Rustamovppl

MCP Finance Toolkit

Rustamovppl/mcp-quickstart

Toolkit financeiro compacto via MCP para cálculos de empréstimos e análise estatística

Ver no GitHub
InicialPluginScore · de 0 a 100

Um servidor MCP em Python com ferramentas de cálculos financeiros (juros compostos, amortização, estatísticas). Implementa o protocolo MCP completo com tools, resources e prompts, pronto para usar em Claude Code, Cursor e Windsurf.

Instalação

$npx convez-ai Rustamovppl/mcp-quickstart

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Calcular juros compostos e rendimentos de investimentos
  • Simular pagamentos de empréstimos e amortizações
  • Análise estatística rápida (média, mediana, desvio padrão)
  • Integrar ferramentas financeiras em agentes Claude

Veredito

Exemplo bem estruturado de servidor MCP em Python com testes e CI integrado. Útil como referência para quem quer construir suas próprias ferramentas MCP ou precisa de cálculos financeiros básicos em automações com Claude.

README

A tradução para o português deste README ainda está na fila.

mcp-quickstart

A small, tested Model Context Protocol server in Python — a little finance toolkit. It exposes finance/stat tools over MCP so any MCP client (Claude Code, Cursor, Windsurf) can call them, and it demonstrates the full MCP surface: tools, a resource, and a prompt.

Built with the official mcp Python SDK (FastMCP).

Tools

ToolDescription
summary_stats(numbers)count / mean / median / stdev for a list
compound_interest(principal, annual_rate, years, compounds_per_year=12)future value + interest earned
loan_payment(principal, annual_rate, months)monthly payment, total paid, total interest (amortizing loan)
percentage_change(old, new)percent change between two values
moving_average(numbers, window)simple moving average over a sliding window
utc_now()current UTC time, ISO-8601

Plus an MCP resource (finance://reference, the conventions the tools assume) and a prompt (savings_plan, a reusable savings-goal template).

Rates are decimals throughout: 0.05 means 5%.

Run

pip install -e ".[dev]"
python server.py

Use it in Claude Code

claude mcp add finance-toolkit -- python /absolute/path/to/server.py

Then ask your agent, e.g. "use loan_payment for a 250000 loan at 6% APR over 360 months" or "run summary_stats on [4, 8, 15, 16, 23, 42]".

Develop

ruff check .   # lint
pytest -q      # tests

Each tool is a plain, validated function, so the math is unit-tested directly (test_server.py) without going through the protocol. CI runs lint + tests on every push (.github/workflows/ci.yml).

Ver o original no GitHub

Bom para