SperatGuillaume/skills-integrate-mcp-with-copilot

O que skills-integrate-mcp-with-copilot faz?

Exercício: Integre o Protocolo de Contexto de Modelo com o GitHub Copilot

Visão Geral

Este exercício guia você pelo processo de integração do Model Context Protocol (MCP) com o GitHub Copilot. O MCP permite que agentes de IA, como o Copilot, se comuniquem com ferramentas e serviços externos de forma padronizada.

Pré-requisitos

• Uma conta do GitHub
• GitHub Copilot ativado no seu ambiente
• Node.js (v18 ou superior)
• npm ou yarn

Passos da Integração

1. Crie um Servidor MCP

Crie um projeto Node.js simples que implemente um servidor MCP:

mkdir mcp-server-example
cd mcp-server-example
npm init -y
npm install @modelcontextprotocol/sdk

Crie um arquivo index.js com o conteúdo a seguir:

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new Server(
  {
    name: "MeuServidorMCP",
    version: "1.0.0",
  },
  {
    capabilities: {
      tools: {},
    },
  }
);

// Defina uma ferramenta de exemplo
server.setRequestHandler("tools/list", async () => ({
  tools: [
    {
      name: "saudacao",
      description: "Envia uma saudação personalizada",
      inputSchema: {
        type: "object",
        properties: {
          nome: { type: "string" },
        },
      },
    },
  ],
}));

server.setRequestHandler("tools/call", async (request) => {
  if (request.params.name === "saudacao") {
    return {
      content: [
        {
          type: "text",
          text: `Olá, ${request.params.arguments?.nome || "mundo"}!`,
        },
      ],
    };
  }
  throw new Error("Ferramenta desconhecida");
});

const transport = new StdioServerTransport();
await server.connect(transport);
console.error("Servidor MCP rodando via stdio");

2. Configure o Copilot para usar o servidor MCP

No diretório do seu projeto, crie um arquivo .github/copilot-instructions.md (se ainda não existir) e adicione:

Usar o servidor MCP localizado em ./mcp-server-example

Em seguida, edite ou crie o arquivo de configuração do Copilot (.vscode/settings.json ou settings.json no seu editor) para incluir:

{
  "github.copilot.advanced": {
    "mcpServers": {
      "MeuServidorMCP": {
        "command": "node",
        "args": ["caminho/para/seu/index.js"]
      }
    }
  }
}

3. Teste a Integração

Abra um arquivo no editor com o Copilot ativo e comece a digitar um comentário como:

// Use a ferramenta saudacao para dizer olá ao Copilot

O Copilot deve reconhecer a ferramenta MCP e oferecer sugestões baseadas nela.

Solução de Problemas

• Verifique se o servidor está rodando sem erros
• Confira se o caminho no args está correto
• Reinicie o editor após alterar as configurações

Recursos Adicionais

• Documentação do Model Context Protocol
• Guia do GitHub Copilot
• Exemplos de MCP

---

Divirta-se integrando e explore as possibilidades que o MCP oferece com o Copilot!