apitdn/MCP_GUIDE.md

Guia do Servidor MCP: Wiki Técnica Fluig

Este guia explica como configurar e utilizar o servidor MCP (Model Context Protocol).

1. Pré-requisitos

• Python 3.9+ e pip install -r requirements.txt

2. Modos de Operação

A. Uso Local (Recomendado para o Dono do Projeto)

A IA lê os arquivos diretamente do seu disco. Configuração no Claude:

{
  "mcpServers": {
    "fluig-local": {
      "command": "python",
      "args": ["C:/dev/apitdn/mcp_server.py"]
    }
  }
}

B. Uso Remoto Sem Download (Para sua Equipe via Tailscale)

O usuário NÃO precisa baixar a Wiki ou os dados. Ele se conecta ao seu servidor dietpi.

1. No seu Servidor (DietPi): Deixe o servidor rodando: python mcp_server.py --mode sse --port 8001

2. Na Máquina do Usuário: O usuário baixa apenas o arquivo mcp_remote_proxy.py e configura o Claude dele:

{
  "mcpServers": {
    "fluig-remoto": {
      "command": "python",
      "args": ["C:/caminho/para/mcp_remote_proxy.py", "--url", "http://dietpi.tail706a7a.ts.net:8001/sse"]
    }
  }
}

3. Ferramentas Disponíveis

• search_docs(query): Busca semântica na Wiki.
• get_code_snippets(language): Retorna exemplos de código JS/Java/SQL.

---

Vantagens do Uso Remoto:

• Zero Download: O usuário não precisa de 1GB de docs.
• Sempre Atualizado: Você atualiza no servidor e todos recebent na hora.
• Segurança: Os dados originais não saem do seu servidor.