Skip to main content
Glama
raphaelmdcoelho

Store MCP Demo

README.md
# Store MCP Demo

Este projeto cria um servidor MCP simples em Node.js + TypeScript para demonstrar, ao vivo, os conceitos de tools, resources e prompts com transporte stdio.

## Requisitos

- Node.js 20+
- npm

## Como rodar

```bash
npm install
npm run build
npm start
```

O servidor fica aguardando mensagens MCP via stdio.

## Conectar no MCP Inspector

Para testar visualmente antes da apresentação:

```bash
npx @modelcontextprotocol/inspector
```

No inspector, escolha a opção de conexão via stdio e rode o comando:

```bash
npm start
```

## Conectar no GitHub Copilot Chat no VS Code

Crie um arquivo .vscode/mcp.json na raiz do projeto com o seguinte conteúdo:

```json
{
  "servers": {
    "store-mcp-demo": {
      "type": "stdio",
      "command": "node",
      "args": ["c:/Business/Programmers/AI/Presentation/github_copilot_mcp/dist/server.js"]
    }
  }
}
```

Lembretes importantes:
- O MCP só fica visível no modo Agent do Copilot Chat, não em Ask/Edit.
- O VS Code pede confirmação antes de cada execução de tool.

## Estrutura do projeto

- src/server.ts: setup do servidor MCP e registro das primitivas
- src/tools: implementação das tools
- src/resources: implementação dos resources
- src/prompts: implementação dos prompts
- src/data: dados mockados em JSON

## Demonstração rápida

A demo pode seguir esta ordem:
1. Listar tools
2. Consultar o catálogo via resource
3. Buscar produtos com search_products
4. Ler detalhes de um produto com get_product_details
5. Consultar estoque com check_stock
6. Criar um pedido com place_order para mostrar efeito colateral