llama-server Web UI에서 MCP 서버 설정하기: 실용 가이드

llama-server가 최근 MCP(Model Context Protocol) 지원을 추가했으며, 레딧 사용자가 웹 UI에서 이를 작동시키는 정확한 단계를 문서화했습니다. 이 가이드는 로컬 llama-server 인스턴스에 MCP 서버를 통합하려는 개발자들을 위한 구체적인 설정 지침을 제공합니다.

설정 요구사항

먼저 uv가 설치되어 있는지 확인하세요. 이 가이드는 공식 설치 문서를 참조합니다: https://docs.astral.sh/uv/getting-started/installation/.

설정 파일

선택한 디렉토리에 MCP 서버 정의가 포함된 config.json 파일을 생성하세요. 예시에는 세 개의 서버가 포함되어 있습니다:

{
  "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"]
    }
  }
}

프록시 실행

동일한 디렉토리에서 다음 명령어를 실행하세요:

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

이 명령어를 실행하면 각 MCP 서버의 이름이 나열됩니다. llama-server 웹 UI에서 서버가 작동하려면 각 URL 끝의 sse를 mcp로 바꿔야 합니다.

예시: http://127.0.0.1:8001/servers/time/sse를 http://127.0.0.1:8001/servers/time/mcp로 변경

웹 UI 설정

llama-server 웹 UI에서 설정 → MCP → 새 서버 추가로 이동하여 설정 파일의 각 서버를 추가하세요. 예를 들어:

• 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

각 서버 추가를 완료하려면 추가를 클릭한 다음, 토글을 확인하여 활성화하세요. 구성된 MCP 서버가 이제 llama-server 웹 UI에서 작동해야 합니다.