openviking-mcp

OpenViking MCP to narzędzie do uruchomienia serwera RAG, który udostępnia wyszukiwanie semantyczne i odpowiadanie na pytania z dokumentów bezpośrednio w Claude Desktop lub innych klientach MCP. Zamiast ręcznego szukania w bazach danych, wysyłasz zapytanie, a system automatycznie znajduje relevantne fragmenty i generuje odpowiedź. Wymaga Python 3.13+, klucza API OpenAI oraz narzędzia uv.

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.