Operações de negóciosCódigo-fonte público

mcp-finance

Servidor MCP de Finanças e Contabilidade — faturas, despesas, contas, lançamentos contábeis, conciliação e relatórios financeiros para agentes de IA. Multi-backend: QuickBooks Online, Xero e um razão local em memória para testes.

Abrir o código-fonte Leia o guia oficial ↗

O que ele oferece a um agente

Uma capacidade feita sob medida por trás de uma conexão MCP.

O servidor possui sua lógica de domínio e publica um contrato de ferramenta que um cliente MCP pode descobrir. O ADK-Rust pode carregar esse contrato em um agente, normalizar cada esquema para o provedor de modelo escolhido e manter o ciclo de vida da conexão fora da lógica de negócio do agente.

14 ferramentas financeiras cobrindo todo o ciclo contábil

Multi-backend: QuickBooks Online, Xero ou razão local

Modo demo zero-config (razão local com dados iniciais)

Compatível com registro via manifesto mcp-server.toml

Ferramentas classificadas por risco para controles de governança

Arquitetura

Como mcp-finance se encaixa em um sistema de agente.

O modelo nunca precisa dos detalhes de implementação ou credenciais do sistema por trás do servidor. Ele vê definições de ferramentas revisadas. O cliente MCP lida com descoberta e chamadas, enquanto o servidor mantém a propriedade da validação, política e comunicação com seu sistema de domínio.

Agente ADK-Rust

Escolhe uma capacidade do catálogo de ferramentas revisado.

→

Cliente MCP

Descobre esquemas, envia chamadas e recebe conteúdo tipado.

→

mcp-finance

Valida a solicitação e possui 14 contratos de ferramentas documentados.

→

Sistema de domínio

Mantém a API, dados, credenciais e regras de negócio por trás do servidor.

Conexão: stdio · Framework do servidor: ADK MCP SDK + rmcp

Diagrama de arquitetura de mcp-finance do seu repositório oficial

Catálogo de ferramentas

O que um agente pode pedir para mcp-finance fazer?

Cada ferramenta tem um nome estável, um propósito legível por humanos e um contrato de entrada JSON descoberto durante a inicialização MCP. Classes de risco vêm do manifesto do registro do projeto quando disponível.

14 ferramentas nomeadas

list_invoices

Listar faturas com filtro opcional de status (paga, não paga, atrasada, rascunho)

read only

get_invoice

Obter detalhes da fatura por ID

read only

create_invoice

Criar uma nova fatura

internal write

list_expenses

Listar despesas/contas com filtro opcional de categoria

read only

create_expense

Registrar uma nova despesa

internal write

list_accounts

Listar plano de contas

read only

get_account_balance

Obter saldo da conta por ID

read only

list_transactions

Listar transações recentes com filtro opcional de conta

read only

create_journal_entry

Criar lançamento contábil (débito/crédito). Débitos devem igualar créditos.

financial action

reconcile_transaction

Conciliar uma transação associando-a a uma fatura ou despesa

internal write

get_profit_loss

Obter relatório de Lucros & Perdas para um intervalo de datas

read only

get_balance_sheet

Obter balanço patrimonial em uma data específica

read only

Governança

Entenda o efeito de cada ferramenta.

Uma conexão de servidor herda a autoridade de suas credenciais e do ambiente de implantação. As declarações abaixo vêm do README deste projeto e do manifesto do registro MCP; sua aplicação ainda decide quais ferramentas um agente recebe e onde a aprovação é necessária.

10 read only3 internal write1 financial action

O manifesto do registro declara classes de risco para leitura, escrita interna e ações financeiras.

Superfície MCP

O que a documentação atual declara.

O MCP pode transportar ferramentas, recursos, prompts, resultados estruturados, progresso, cancelamento e trabalhos de longa duração. Este registro destaca os recursos modernos do protocolo explicitamente mencionados por este repositório.

O README atual concentra-se em sua superfície de ferramentas. Verifique o código-fonte e as notas de versão antes de confiar em capacidades MCP opcionais além da descoberta e invocação de ferramentas.

ADK MCP SDKrmcpManifesto do registro

Instalar e conectar

Siga o ponto de partida documentado do projeto.

Instale o servidor no ambiente que possui suas credenciais e acesso ao domínio. Adicione-o ao seu host MCP, verifique as ferramentas descobertas e restrinja o conjunto de ferramentas antes de entregá-lo a um agente de produção.

Instalar

cargo install mcp-finance

Configuração do cliente MCP

{
  "mcpServers": {
    "finance": {
      "command": "/path/to/mcp-finance",
      "env": {
        "QUICKBOOKS_ACCESS_TOKEN": "your-token",
        "QUICKBOOKS_REALM_ID": "your-realm-id"
      }
    }
  }
}

Comandos e configurações são extraídos do README público. Confirme pré-requisitos, variáveis de ambiente e opções específicas da versão na documentação oficial antes da implantação.

Documentação oficial

Continue com a fonte de verdade dos mantenedores do projeto.

Esta página fornece um mapa acessível do servidor. O repositório permanece autoritativo para esquemas exatos, pré-requisitos, configuração, exemplos, testes, versões e atualizações de segurança.

Visão Geral ↗README.md Arquitetura ↗docs/assets/architecture.svg Problemas e suporte ↗problemas no github.com

Continue explorando