MCP-guide

🔧 Guia de Integração do Servidor MCP com o Cline usando venv

✅ Visão Geral

Este guia explica como utilizar um projeto de exemplo MCP no GitHub, construir um servidor MCP em um ambiente virtual Python (venv) e integrá-lo com a extensão "Cline" do VS Code. Também realizaremos a verificação de funcionamento com o MCP Inspector.

1. Obtenção do Projeto MCP

📦 1.1 Clonar o repositório do GitHub

git clone https://github.com/m-hikichi/MCP-guide.git
cd MCP-guide

✅ ${PROJECT_DIR} = caminho completo de MCP-guide (exemplo: C:/Users/yourname/Documents/MCP-guide)

2. Configuração do Ambiente Virtual Python

🐍 2.1 Criar o ambiente virtual

python -m venv venv

🔁 2.2 Ativar o ambiente virtual

• Prompt de comando:

  .\venv\Scripts\activate.bat
  

• PowerShell:

  .\venv\Scripts\activate.ps1
  

3. Instalação dos Pacotes de Dependência (usando requirements.txt)

Com o ambiente virtual ativado, execute a instalação usando o requirements.txt incluído no projeto clonado:

pip install -r requirements.txt

✅ O mcp[cli] contém todos os pacotes necessários.

4. Inicialização do Servidor MCP e Verificação com o Inspector

🧪 4.1 Inicialização do MCP Inspector

Execute o seguinte comando para iniciar o MCP Inspector:

mcp dev mcp_server.py

Ao obter sucesso, o navegador abrirá automaticamente e o MCP Inspector será exibido.

• Na aba Tools, você pode testar funções como add
• Na aba Resources, é possível verificar o acesso aos recursos

5. Integração com a Extensão Cline

⚙️ 5.1 Edição do cline_mcp_settings.json

Abra a paleta de comandos no VS Code, execute > Cline: Configure MCP Servers e adicione a seguinte configuração:

{
  "mcpServers": {
    "local_mcp_server": {
      "command": "${PROJECT_DIR}/venv/Scripts/mcp.exe",
      "args": [
        "dev",
        "${PROJECT_DIR}/mcp_server.py"
      ]
    }
  }
}

✅ Substitua ${PROJECT_DIR} pelo caminho completo do diretório MCP-guide
❌ O caminho não pode conter espaços
✅ O caminho pode conter caracteres japoneses

6. Uso no Cline

1. Abra a visualização de chat no VS Code
2. Alterne o servidor MCP para local_mcp_server
3. Realize chamadas de ferramentas como add(a=2, b=3) e verifique se funcionam corretamente