lincolnlopes/mcp-server
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
- Instale as dependências:
npm install
- Compile o projeto:
npm run build
- 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
- Acesse: https://inspector.modelcontextprotocol.org/
- No campo de conexão, digite o endpoint do seu servidor, por exemplo:
http://localhost:3000/mcp
- Clique em conectar para acessar a interface visual.
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
- Build Your First MCP Server with TypeScript (Hackteam)
- Copilot Developer Camp
- Model Context Protocol TypeScript SDK
- Playwright MCP
- Introducing Model Context Protocol (MCP) in Copilot Studio: Simplified Integration with AI Apps and Agents (Microsoft Blog)
- my-first-mcp-server (Yusuke Wada)
About the Author
Lincoln Lopes (GitHub: lincolnlopes)
- Developer from Brazil
- Email:
- Main skills: TypeScript, JavaScript, Node.js, .NET, Docker, React, SQL, Git