Criando um MCP server com NodeJS (ai-agent-with-mcp)

Este projeto implementa um agente de IA que utiliza o Model Context Protocol (MCP) para interagir com recursos externos.

O repositório inclui:

Um servidor MCP funcional, com recursos REST para usuários e mensagens.

Um cliente MCP para consumir esses recursos via protocolo.

Exemplos práticos de como acessar os recursos por terminal, via API REST ou diretamente no Cursor.

Recursos Disponíveis

O servidor MCP fornece os seguintes recursos:

Recursos de Usuários

• api://users: Lista todos os usuários cadastrados no sistema
  • Retorna informações como ID, nome, número de telefone e thread ID
  • Formato: JSON
  • Exemplo de resposta:
    *Configuration content*bash
    npx -y @smithery/cli@latest install @wonderwhy-er/desktop-commander --client cursor --key dda23bec-caa6-4487-a1e9-eb74e22e33eb

Obs: a key mencionada é somente para exemplo, você precisa adicionar a sua.

Reinicie o Cursor se estiver em execução.

### Opção 2: Instalação Manual

Adicione a entrada apropriada ao seu arquivo mcp.json:

#### Para Mac/Linux:

No Linux: `~/.config/cursor.json`

*Configuration content*

#### Para Windows:

*Configuration content*

Reinicie o Cursor se estiver em execução.

### Opção 3: Clonar localmente

Clone e construa:

```bash
git clone https://github.com/moises-paschoalick/ai-agent-with-mcp.git
cd ai-agent-with-mcp
npm run setup

Reinicie o Cursor se estiver em execução.

O comando de configuração irá:

• Instalar dependências
• Construir o servidor
• Configurar o Cursor
• Adicionar servidores MCP à configuração do Cursor, se necessário

Como Usar

Cliente MCP

O projeto inclui um cliente MCP que pode ser usado para acessar os recursos disponíveis:

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

async function main() {
  const client = new Client({
    name: "hello-mcp-client",
    version: "1.0.0"
  });
  const transport = new StdioClientTransport({
    command: "node",
    args: ["build/index.js"]
  });
  
  try {
    await client.connect(transport);
    
    // Listar recursos disponíveis
    const resources = await client.listResources();
    console.log("Recursos disponíveis:", resources);
    
    // Ler o recurso de usuários
    const content = await client.readResource({ uri: "api://users" });
    console.log("\nLista de Usuários:", content);
  } catch (error) {
    console.error("Erro ao executar o cliente:", error);
  }
}

main().catch(console.error);

API REST Direta

Você também pode acessar os recursos diretamente via API REST:

# Listar todos os usuários
curl http://3.238.149.189:8080/users

Instalação e Execução

# Instalar dependências
npm install

# Compilar o projeto
npm run build

# Executar o servidor
npm start

# Executar em modo de desenvolvimento
npm run dev

Requisitos

• Node.js (versão compatível com AbortController)
• TypeScript
• @modelcontextprotocol/sdk