mcpField
M
MCP Server

MCP Server

Local
github.com/lincolnlopesDeveloper Tools0Updated 77w ago
Repository

About MCP Server

This project is a Node.js and TypeScript MCP server using Express and the official MCP SDK. It provides a local HTTP endpoint and basic instructions for running and inspecting the server.

Key features

  1. 01Node.js and TypeScript implementation
  2. 02Express-based server
  3. 03MCP endpoint at /mcp
  4. 04Build and start scripts
  5. 05MCP Inspector testing instructions

Use cases

  1. 01Run a local MCP server during development
  2. 02Build the TypeScript project
  3. 03Inspect MCP requests and tools over HTTP

MCP support

Implements an MCP server with a POST /mcp endpoint for MCP requests. The README explains how to connect the external MCP Inspector.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "lincolnlopes": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
Run commandnpx -y @modelcontextprotocol/inspector

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@modelcontextprotocol/inspector

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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 fixes/, especialmente o arquivo fixes/20250505-errorcode.md 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: [email protected]
  • Main skills: TypeScript, JavaScript, Node.js, .NET, Docker, React, SQL, Git

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.