mcp-server

lincolnlopes/mcp-server

3.2

If you are the rightful owner of mcp-server 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.

This project is an MCP (Model Context Protocol) server implemented in Node.js with TypeScript.

MCP Server

Este projeto é um servidor MCP (Model Context Protocol) implementado em Node.js com TypeScript.

Como executar

  1. Instale as dependências:
    npm install
    
  2. Compile o projeto:
    npm run build
    
  3. Inicie o servidor:
    npm start
    

O servidor ficará disponível em http://localhost:3000/.

Endpoints principais

  • POST /mcp: Endpoint principal para requisições MCP.
  • GET /: Mensagem de status do servidor.

Desenvolvimento

  • O código fonte está em src/.
  • O build gerado vai para dist/.
  • O servidor utiliza Express e o SDK oficial do Model Context Protocol.

Ferramentas de inspeção

Para testar e inspecionar seu servidor MCP, utilize o MCP Inspector oficial.

Como usar o MCP Inspector

O MCP Inspector não roda embutido no seu servidor MCP. Ele é uma ferramenta externa, feita para se conectar ao seu endpoint MCP via HTTP, assim como Postman ou Insomnia, mas com suporte nativo ao protocolo MCP.

Opção 1: Usar o site oficial
Opção 2: Rodar localmente
  • Execute no terminal:
    npx @modelcontextprotocol/inspector http://localhost:3000/mcp
    
  • Isso abrirá a interface do Inspector no navegador (geralmente em http://localhost:6274).
Observações
  • O Inspector é sempre um cliente externo, não um plugin do seu servidor.
  • Não tente acessar /mcp diretamente pelo navegador, pois ele faz GET e o endpoint espera POST.
  • O Inspector faz as requisições POST corretamente e mostra tudo em uma interface amigável.
  • Se estiver rodando em um servidor remoto, certifique-se de liberar a porta 3000 no firewall.

Fixes e informações detalhadas

Para detalhes sobre problemas e correções aplicadas, consulte a pasta , especialmente o arquivo para entender o caso do ErrorCode e como foi solucionado.

Documentação oficial (alternativa)

Para mais detalhes, consulte a documentação oficial (em inglês, com opção de tradução automática pelo navegador):

Ou utilize a tradução automática do Google Chrome ou este link traduzido para acessar a documentação em português.

Fontes e Referências

About the Author

Lincoln Lopes (GitHub: lincolnlopes)

  • Developer from Brazil
  • Email:
  • Main skills: TypeScript, JavaScript, Node.js, .NET, Docker, React, SQL, Git