Configurando Servidores MCP no Web UI do llama-server: Um Guia Prático

O llama-server adicionou recentemente suporte ao MCP (Model Context Protocol), e um usuário do Reddit documentou os passos exatos para fazê-lo funcionar na interface web. Este guia fornece instruções concretas de configuração para desenvolvedores que desejam integrar servidores MCP com sua instância local do llama-server.

Requisitos de Configuração

Primeiro, certifique-se de que o uv está instalado. O guia faz referência à documentação oficial de instalação em https://docs.astral.sh/uv/getting-started/installation/.

Arquivo de Configuração

Crie um arquivo config.json no diretório de sua escolha com definições de servidores MCP. O exemplo inclui três servidores:

{
  "mcpServers": {
    "time": {
      "command": "uv",
      "args": ["run", "mcp-server-time", "--local-timezone=America/Chicago"]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "ddg-search": {
      "command": "uvx",
      "args": ["duckduckgo-mcp-server"]
    }
  }
}

Executando o Proxy

Do mesmo diretório, execute este comando:

uvx mcp-proxy --named-server-config config.json --allow-origin "*" --port 8001 --stateless

Ao executar este comando, ele lista o nome de cada servidor MCP. Você precisa substituir o sse no final de cada URL por mcp para que os servidores funcionem na interface web do llama-server.

Exemplo: Altere http://127.0.0.1:8001/servers/time/sse para http://127.0.0.1:8001/servers/time/mcp

Configuração da Interface Web

Na interface web do llama-server, vá para Configurações → MCP → Adicionar Novo Servidor e adicione cada servidor do seu config. Por exemplo:

• http://127.0.0.1:8001/servers/time/mcp
• http://127.0.0.1:8001/servers/fetch/mcp
• http://127.0.0.1:8001/servers/ddg-search/mcp

Clique em Adicionar para finalizar a adição de cada servidor, depois marque a alternância para ativá-lo. Os servidores MCP configurados agora devem funcionar na interface web do llama-server.