🔌 Model Context Protocol: crie seu primeiro servidor MCP

Nível 4 · 👁️ Polifemo · ⏱️ ~25 min · Pré-requisitos: Node.js instalado e noções básicas de terminal/JavaScript

📌 Pra que serve

O Model Context Protocol (MCP) é um padrão aberto criado pela Anthropic — hoje adotado também por OpenAI, Google DeepMind e Microsoft — que permite conectar um modelo de IA a ferramentas e dados externos (banco de dados, issue tracker, arquivos) usando uma única interface, em vez de reescrever a integração pra cada modelo. Segundo o relatório da Stacklok (2026), 41% das equipes de software já rodam servidores MCP em produção.

🛠️ Passo a passo

1. Instale o Node.js (v18+) se ainda não tiver.

2. Crie o projeto:

mkdir meu-servidor-mcp && cd meu-servidor-mcp
npm init -y
npm install @modelcontextprotocol/sdk zod

3. Crie um arquivo server.js com um servidor mínimo que expõe uma ferramenta (tool):

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { z } from 'zod';
const server = new McpServer({ name: 'meu-servidor', version: '1.0.0' });
server.tool(
  'buscar_issues',
  'Busca no rastreador de issues por palavra-chave. Retorna títulos e IDs correspondentes.',
  { query: z.string().describe('Palavra-chave para buscar') },
  async ({ query }) => {
    // aqui entra sua lógica real (banco, API, etc.)
    return { content: [{ type: 'text', text: Resultados para: ${query} }] };
  }
);await server.connect(new StdioServerTransport());

4. Rode o servidor:

node server.js

5. Conecte a um cliente MCP-compatível — Claude Code, Cursor ou Windsurf têm configuração "one-click" para apontar pro seu servidor local (via stdio) nas configurações de MCP do app.

6. Teste: peça ao assistente algo que exija a ferramenta ("busque issues