Back Office TD

Servidor Model Context Protocol (MCP) para operações de BackOffice de Investimentos. A solução fornece ferramentas para consulta de informações de investidores e suas contas de investimento.

Estrutura da Solução

MCPServerBackOfficeTD/
├── MCPServerBackOfficeTD.sln              # Arquivo de solução Visual Studio
├── .gitignore                              # Configuração para Git
├── README.md                               # Este arquivo
├── RESUMO_TESTES.md                        # Resumo dos resultados de testes
│
├── MCPServerBackOfficeTD.Console/           # Projeto principal - Console MCP Server
│   ├── MCPServerBackOfficeTD.Console.csproj # Arquivo de projeto
│   ├── Program.cs                           # Ponto de entrada - Configuração do servidor MCP
│   ├── CadastroInvestidor.cs               # Domínio de cadastro de investidores
│   ├── CargaTestes.cs                      # Dados de teste simulados
│   └── Modelos/
│       ├── InvestidorUnico.cs              # Record struct de Investidor
│       └── Conta.cs                        # Record struct de Conta
│
└── MCPServerBackOfficeTD.Tests/             # Projeto de testes unitários
    ├── MCPServerBackOfficeTD.Tests.csproj  # Arquivo de projeto de testes
    ├── Usings.cs                           # Importações globais
    ├── CadastroInvestidorTests.cs          # Testes para CadastroInvestidor
    ├── README.md                           # Documentação de testes
    └── TESTES.md                           # Plano detalhado de testes

Pré-requisitos

• .NET 10.0 ou superior
• Visual Studio 2024, Visual Studio Code ou Rider
• Sistemas operacionais suportados: Windows, Linux, macOS

Dependências Principais

MCPServerBackOfficeTD.Console

• ModelContextProtocol (v1.2.0): Framework para implementar servidores MCP
• Microsoft.Extensions.Hosting (v10.0.5): Host genérico para aplicações .NET
• Microsoft.Extensions.Logging (v10.0.5): Framework de logging

MCPServerBackOfficeTD.Tests

• xunit (v2.8.1): Framework de testes
• Microsoft.NET.Test.Sdk (v17.11.1): SDK de testes para .NET
• xunit.runner.visualstudio (v2.8.1): Runner de testes do xunit para VS

Compilação

Via Visual Studio

1. Abra o arquivo MCPServerBackOfficeTD.sln
2. Clique em Build > Build Solution ou pressione Ctrl+Shift+B

Via Terminal (dotnet CLI)

# Compilar toda a solução
dotnet build

# Compilar projeto específico
dotnet build MCPServerBackOfficeTD.Console

# Compilar em Release
dotnet build --configuration Release

Execução

Executar o Servidor MCP

# Via dotnet CLI
dotnet run --project MCPServerBackOfficeTD.Console/MCPServerBackOfficeTD.Console.csproj

# Ou entre no diretório do projeto
cd MCPServerBackOfficeTD.Console
dotnet run

O servidor iniciará e estará pronto para aceitar chamadas de ferramentas MCP.

Testes

Executar Testes Unitários

# Executar todos os testes
dotnet test

# Executar testes com saída detalhada
dotnet test -v detailed

# Executar um projeto de testes específico
dotnet test MCPServerBackOfficeTD.Tests

# Executar um teste específico
dotnet test --filter "ObterInformacoesInvestidor"

# Executar com cobertura de código
dotnet test /p:CollectCoverage=true

Funcionalidades Disponíveis

Ferramentas MCP Disponíveis

1. Obter_Informacoes_Investidor

Retorna informações cadastrais detalhadas do primeiro investidor disponível.

Parâmetros: Nenhum

Retorno: String contendo informações do investidor (Nome, CPF, Data de Nascimento, Endereço, Telefone, Email)

2. Obter_Informacoes_Investidor_Por_Conta

Retorna informações de investidor a partir de um código de participante e número de conta.

Parâmetros:

• CodigoParticipante (string): Código do participante
• NumeroConta (string): Número da conta

Retorno: Informações da conta correspondente

3. Obter_Contas_Investidor

Retorna lista de contas vinculadas a um investidor através de CPF ou UID.

Parâmetros:

• cpf (string, opcional): Número do CPF do investidor
• investidorUid (int, opcional): Identificador único do investidor

Retorno: Lista de contas do investidor

Modelos de Dados

InvestidorUnico (Record Struct)

public readonly record struct InvestidorUnico(
    int UidInvestidor,
    string CPF,
    string? Nome = null,
    string? DataNascimento = null,
    string? Endereco = null,
    string? Telefone = null,
    string? Email = null)

Conta (Record Struct)

public readonly record struct Conta(
    int UidInvestidor,
    string CodigoParticipante,
    string NumeroConta,
    int ContaId,
    string TipoConta,
    decimal Saldo)

Dados de Teste

A aplicação inclui dados de teste simulados em CargaTestes.cs:

• 7 investidores com informações completas
• 9 contas distribuídas entre os investidores
• Tipos de conta: Poupança, Corrente, Investimento

Desenvolvimento

Padrões de Código

• Namespace Hierarchy: Organização clara de namespaces por funcionalidade
• Record Structs: Utilizados para modelos de dados imutáveis
• XML Documentation: Comentários XML para documentação de métodos e classes
• Atributos MCP: Uso de [McpServerToolType] e [McpServerTool] para registrar ferramentas

Convenções de Nomenclatura

• Classes: PascalCase (ex: CadastroInvestidor)
• Métodos: PascalCase (ex: ObterInformacoesInvestidor)
• Parâmetros: camelCase (ex: codigoParticipante)
• Constantes: UPPER_SNAKE_CASE (quando aplicável)

Roadmap Futuro

• Integração com banco de dados real
• Implementação completa de operações CRUD
• Validação de conformidade LGPD
• Testes de integração com MCP Client
• API REST adicional
• Autenticação e autorização
• Logging estruturado

Conformidade

• LGPD: Implementação de mecanismos de privacidade para dados pessoais
• .NET 10.0: Última versão LTS do framework
• MCP Protocol: Implementação conforme especificação

Suporte

Para problemas, dúvidas ou sugestões:

1. Verifique TESTES.md para plano de testes
2. Verifique RESUMO_TESTES.md para histórico de execução de testes
3. Abra uma issue no repositório

Licença

Todos os direitos reservados. Propriedade do projeto MCPServerBackOfficeTD.

Histórico de Mudanças

Ver RESUMO_TESTES.md para histórico de execução de testes e validações.

---

Última atualização: 29 de Março de 2026