openviking-mcp

Set up and run the OpenViking MCP server for RAG capabilities. Use when users need semantic search and document Qu0026A exposed through Model Context Protocol for Claude Desktop/CLI or other MCP clients. Triggers on requests about OpenViking MCP, RAG servers, or semantic search MCP setup.

1. Sklonuj repozytorium OpenViking: uruchom git clone https://github.com/ZaynJarvis/openviking.git, następnie przejdź do katalogu openviking/examples/mcp-query.

2. Zainstaluj zależności poleceniem uv sync — upewnij się, że masz zainstalowany Python 3.13+ i narzędzie uv.

3. Skonfiguruj klucze API: skopiuj plik ov.conf.example na ov.conf i edytuj go, wpisując swój klucz OpenAI API w pola vlm.token (dla generowania odpowiedzi) i embedding.token (dla wyszukiwania semantycznego).

4. Uruchom serwer MCP — instrukcje znajdują się w README projektu, serwer będzie nasłuchiwać na porcie HTTP i czekać na połączenia od Claude Desktop lub innego klienta MCP.

5. W Claude lub innym kliencie MCP połącz się z serwerem i użyj narzędzia query do wysyłania pytań — system automatycznie przeszuka dokumenty i wygeneruje odpowiedź, lub użyj search tylko do wyszukiwania relevantnych fragmentów bez generowania odpowiedzi.

6. Aby dodać nowe dokumenty, użyj narzędzia add_resource z ścieżką do pliku, katalogu lub adresu URL — system zindeksuje zawartość i będzie ją uwzględniać w przyszłych zapytaniach.