mcpserver.study.minimal

Minimal MCP Server

Este projeto é um servidor MCP (Model Context Protocol) minimalista em C#/.NET, pronto para ser usado como backend para clientes MCP (como extensões, automações ou integrações).

Funcionalidades

• Exposição de ferramentas MCP via transporte stdio
• Ferramentas disponíveis:

- Echo: Retorna a mensagem enviada - ReverseEcho: Retorna a mensagem invertida - WhatTimeItIs: Retorna a data e hora atual do servidor

Como executar

Pré-requisitos

• .NET SDK 9.0 ou superior

Rodando localmente

1. Clone ou baixe este repositório
2. No terminal, navegue até a pasta MinimalMcpServer
3. Execute:

   dotnet run

O servidor MCP estará pronto para receber comandos via stdio.

Como usar com um cliente MCP

• Configure o cliente MCP para iniciar este servidor usando o comando acima.
• O cliente deve se comunicar via stdio (entrada/saída padrão).
• Exemplos de clientes MCP: extensões VS Code, scripts Python, automações, etc.

Exemplo de chamada (JSON)

Para chamar a ferramenta Echo:

{
  "tool": "Echo",
  "args": { "message": "Olá, mundo!" }
}

Para chamar a ferramenta WhatTimeItIs:

{
  "tool": "WhatTimeItIs",
  "args": {}
}

A resposta será um JSON com o resultado.

Personalização

Adicione novas ferramentas criando métodos estáticos decorados com [McpServerTool] dentro de uma classe marcada com [McpServerToolType].

Projeto exemplo para estudos e integrações MCP.