mcp-server-dotnet

jrlimar/mcp-server-dotnet

3.1

If you are the rightful owner of mcp-server-dotnet and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The MCP-Server-DotNet is a server implementation designed to handle Model Context Protocol (MCP) requests using the .NET framework.

📚 API .NET 9 com MCP (Model Context Protocol)

Este projeto demonstra como integrar uma API em .NET 9 com o MCP (Model Context Protocol) para expor funcionalidades que podem ser consumidas por modelos de linguagem, como o Claude Desktop.

🚀 Estrutura do Projeto

  • Mcp.Server → Projeto console em .NET 9 que implementa o servidor MCP Stdio.
  • Mcp.StreambleHttp → Projeto Api em .NET 9 que implementa o servidor MCP StreambleHttp.
  • Mcp.Api → Endpoints que expõem as operações também via HTTP, se necessário.

O objetivo é permitir que um modelo de linguagem:

  1. Entenda comandos do usuário em linguagem natural.
  2. Converta em chamadas MCP para a API.
  3. Retorne resultados de forma natural.

🛠️ Pré-requisitos

🔍 Testando o MCP Server Stdio

  1. Abra o terminal na pasta do projeto McpServer.
  2. Rode o servidor usando o inspector oficial:
npx @modelcontextprotocol/inspector dotnet run

inspector

💻 Integrando com o Claude Desktop

Para conectar o Claude Desktop ao MCP Server:

Abra as configurações: Settings > Developer > Edit Config > Edite o arquivo claude_desktop_config.json e adicione:

{
  "mcpServers": {
    "mcp-server-stdio": {
      "command": "D:\\github\\mcp-server-dotnet\\src\\Mcp.Server\\bin\\Debug\\net9.0\\Mcp.Server.exe",
      "args": [],
      "type": "stdio"
    }
  },
  "mcp-streamblehttp": {
    "command": "npx",
    "args": [
      "mcp-remote",
      "http://localhost:5147/sse"
    ]
  }
}

Reinicie o Claude Desktop para aplicar as alterações.

✅ Fluxo de Funcionamento

O usuário digita no Claude Desktop algo como:

"Liste os livros disponíveis"

O Claude interpreta a intenção e chama a tool do MCP Server (ObterLivros).

O MCP Server retorna os dados em formato estruturado (JSON).

O Claude transforma em linguagem natural e responde:

"Atualmente temos: Clean Code, O Senhor dos Anéis, Sapiens."

inspector

🔍 Testando o MCP Server com StreambleHttp

📡 Conexão via SSE (depreciado)

A conexão através de Server-Sent Events (SSE) ainda funciona, mas está depreciada e não é recomendada para novos testes.

GET http://localhost:5147/sse

⚡ Conexão via StreambleHttp (recomendado)

A forma atual e recomendada de integração é utilizando StreambleHttp, que suporta comunicação bidirecional baseada em JSON-RPC.

POST http://localhost:5147
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "initialize"
}

Ambas formas funcionam com inspector

  1. Abra o terminal na pasta do projeto McpServer.
  2. Rode o servidor usando o inspector oficial:
npx @modelcontextprotocol/inspector dotnet run