Birdieflemishspeaking787/MCP_Detalhado_Com_Projetos

O que MCP_Detalhado_Com_Projetos faz?

Aprenda MCP com projetos práticos, do nível iniciante ao avançado, conectando modelos de IA, ferramentas e sistemas externos

Introdução

Este repositório contém uma série de projetos práticos para aprender o Model Context Protocol (MCP). O MCP é um protocolo aberto que padroniza a forma como aplicações fornecem contexto e ferramentas para modelos de IA (LLMs). Pense nele como um "USB-C para aplicações de IA" — um padrão universal para conectar modelos de IA a diferentes fontes de dados e ferramentas.

O que é MCP?

O Model Context Protocol (MCP) é um protocolo que permite que servidores exponham recursos e ferramentas para que hosts de IA (como Claude Desktop, Cursor, Codex, etc.) possam utilizá-los. Ele segue um modelo cliente-servidor onde:

• Host: A aplicação que inicia a conexão (ex: Claude Desktop)
• Cliente: Um cliente MCP que mantém uma conexão com o servidor
• Servidor: Um servidor MCP que fornece contexto, ferramentas e funcionalidades

Projetos

Nível Iniciante

Projeto	Descrição
hello-mcp	Seu primeiro servidor MCP: um servidor simples que retorna uma saudação
echo-server	Um servidor de eco que demonstra o fluxo básico de requisição-resposta
weather-mcp	Um servidor que busca dados meteorológicos de uma API externa
todo-mcp	Servidor de gerenciamento de tarefas com operações CRUD

Nível Intermediário

Projeto	Descrição
file-explorer	Um servidor que permite navegar e ler arquivos do sistema
database-query	Um servidor que executa consultas SQL em um banco de dados
calendar-mcp	Integração com Google Calendar para agendar eventos
note-taking	Um servidor de notas com funcionalidades avançadas

Nível Avançado

Projeto	Descrição
multi-tool-agent	Um servidor que combina múltiplas ferramentas em um agente coeso
streaming-analysis	Processamento de dados em tempo real com streaming
auth-mcp	Servidor com autenticação e autorização (OAuth, JWT)
mcp-gateway	Gateway para roteamento entre múltiplos servidores MCP

Como usar

Pré-requisitos

• Node.js 18+ ou Python 3.9+
• Uma chave de API para o modelo de IA (ex: Anthropic, OpenAI)
• Um cliente/host MCP (recomendado: Claude Desktop ou Cursor)

Instalação

# Clone o repositório
git clone https://github.com/Birdieflemishspeaking787/MCP_Detailed_With_Projects.git
cd MCP_Detailed_With_Projects

# Instale as dependências do projeto desejado
cd hello-mcp
npm install

# Configure as variáveis de ambiente
cp .env.example .env
# Edite .env com sua chave de API

Executando um servidor

cd hello-mcp
npm start

Configurando com Claude Desktop

Adicione o seguinte ao seu arquivo de configuração claude_desktop_config.json:

{
  "mcpServers": {
    "hello-mcp": {
      "command": "node",
      "args": ["/caminho/para/hello-mcp/index.js"],
      "env": {
        "API_KEY": "sua-chave-api-aqui"
      }
    }
  }
}

Estrutura de um projeto

Cada projeto segue uma estrutura padrão:

nome-do-projeto/
├── index.js          # Ponto de entrada do servidor
├── package.json      # Dependências e scripts
├── .env.example      # Exemplo de variáveis de ambiente
└── README.md         # Documentação específica do projeto

Recursos

• Documentação oficial do MCP
• Especificação do protocolo
• SDK MCP para TypeScript
• SDK MCP para Python
• Lista de servidores MCP

Licença

MIT