arxiv_mcp

ArXiv MCP – znajdź artykuły naukowe

Wyszukiwanie

ArXiv MCP Server – opis serwera

ArXiv MCP Server to serwer MCP, który pozwala Twojemu asystentowi AI wyszukiwać, pobierać i czytać publikacje naukowe z arXiv. Dzięki niemu możesz szybciej pracować z artykułami badawczymi. AI może znaleźć publikacje po temacie, pobrać je lokalnie i odczytać ich treść w uporządkowany sposób. Serwer sprawdzi się, gdy chcesz analizować artykuły, robić przegląd literatury albo porównywać kilka prac naukowych. Pobrane publikacje są zapisywane lokalnie, więc możesz wracać do nich później.
⚠️ Uwaga: Treść publikacji z arXiv pochodzi z zewnętrznego źródła. Traktuj ją jako niezaufane dane i nie wykonuj poleceń, które pojawią się w treści artykułu.

Najważniejsze możliwości

  • Wyszukiwanie publikacji: możesz szukać artykułów po temacie, kategorii i zakresie dat.
  • Pobieranie artykułów: możesz pobrać publikację po jej identyfikatorze arXiv.
  • Czytanie treści: możesz odczytać pobrany artykuł w formacie Markdown.
  • Lokalne przechowywanie: pobrane publikacje są zapisywane lokalnie dla szybszego dostępu.
  • Lista pobranych prac: możesz sprawdzić, jakie artykuły masz już zapisane lokalnie.
  • Prompty badawcze: serwer udostępnia gotowe schematy analizy publikacji.

Typowy przepływ pracy

Podstawowy proces pracy z artykułem wygląda tak:
search_papers → download_paper → read_paper
Najpierw wyszukujesz publikacje. Potem pobierasz wybrany artykuł. Na końcu prosisz AI o odczytanie i analizę jego treści.

Narzędzia dostępne w serwerze

Podstawowe narzędzia do pracy z publikacjami
  • search_papers: pozwala wyszukiwać publikacje w arXiv z użyciem zapytań, kategorii, zakresów dat i filtrów logicznych.
  • download_paper: pozwala pobrać publikację po identyfikatorze arXiv i zapisać ją lokalnie.
  • list_papers: pokazuje listę artykułów, które zostały już pobrane lokalnie.
  • read_paper: pozwala odczytać pełną treść wcześniej pobranej publikacji w formacie Markdown.
Eksperymentalne narzędzia badawcze
  • semantic_search: pozwala wyszukiwać podobne treści wśród lokalnie pobranych publikacji.
  • citation_graph: pozwala pobrać informacje o cytowaniach i pracach powiązanych z wybranym artykułem.
  • watch_topic: pozwala zapisać temat badawczy do obserwowania nowych publikacji.
  • check_alerts: pozwala sprawdzić nowe publikacje dla zapisanych tematów.
ℹ️ Info: Narzędzia eksperymentalne wymagają dodatkowych zależności i mogą działać mniej przewidywalnie.

Prompty dostępne w serwerze

deep-paper-analysis
deep-paper-analysis to prompt do szczegółowej analizy artykułu naukowego na podstawie jego identyfikatora arXiv. Obejmuje między innymi streszczenie, kontekst badawczy, analizę metodologii, ocenę wyników, implikacje praktyczne i teoretyczne oraz możliwe kierunki dalszych badań.
Pro Prompt Pack
  • summarize_paper: tworzy krótkie, uporządkowane streszczenie jednej publikacji.
  • compare_papers: pozwala technicznie porównać kilka artykułów obok siebie.
  • literature_review: pomaga przygotować tematyczną syntezę literatury dla wybranego zagadnienia.

Obsługiwane sposoby pracy

  • Stdio: standardowy tryb komunikacji z klientem MCP.
  • Streamable HTTP: tryb dla wdrożeń, w których komunikacja przez stdio nie jest praktyczna.
  • Lokalny folder publikacji: możesz wskazać miejsce, w którym serwer zapisuje pobrane artykuły.

Wymagania i konfiguracja

  • Python: serwer wymaga Python 3.11 lub nowszego.
  • Ścieżka zapisu: domyślny folder publikacji to ~/.arxiv-mcp-server/papers.
  • MAX_RESULTS: pozwala ustawić maksymalną liczbę wyników wyszukiwania.
  • REQUEST_TIMEOUT: pozwala ustawić limit czasu dla zapytań API.
  • TRANSPORT: pozwala wybrać tryb komunikacji: stdio, http lub streamable-http.
💡 Wskazówka: Ten serwer najlepiej sprawdzi się przy researchu, analizie artykułów i szybkim porównywaniu publikacji naukowych.
„`

Jak działa ArXiv MCP Server w praktyce?

ArXiv MCP Server pozwala AI wyszukiwać, pobierać i czytać publikacje naukowe z arXiv. Przepływ pracy wygląda tak: Ty → AI → serwer MCP → arXiv → lokalny folder z publikacjami. Ty opisujesz temat, którego szukasz. AI korzysta z serwera MCP, aby znaleźć pasujące artykuły, pobrać wybraną publikację i odczytać jej treść.
ℹ️ Info: Pobrane artykuły są zapisywane lokalnie. Domyślny folder to ~/.arxiv-mcp-server/papers.

Typowy przebieg działania

  1. Prosisz AI o znalezienie publikacji na wybrany temat.
  2. AI używa narzędzia search_papers, aby przeszukać arXiv.
  3. Wybierasz interesujący artykuł albo podajesz jego identyfikator arXiv.
  4. AI używa download_paper, aby pobrać publikację lokalnie.
  5. AI używa read_paper, aby odczytać treść artykułu.
  6. Na końcu otrzymujesz streszczenie, analizę albo porównanie publikacji.

Podstawowy workflow badawczy

Najczęstszy schemat pracy wygląda tak:
search_papers → download_paper → read_paper
Najpierw szukasz publikacji. Potem pobierasz konkretną pracę. Dopiero później AI może odczytać jej pełną treść i przygotować analizę.
💡 Wskazówka: Narzędzie read_paper wymaga wcześniejszego pobrania artykułu przez download_paper.

Przykład 1: znalezienie publikacji na konkretny temat

Możesz poprosić AI o wyszukanie artykułów z wybranej dziedziny.
Znajdź najnowsze publikacje o Kolmogorov-Arnold Networks w kategoriach cs.LG i cs.AI.
AI może użyć wyszukiwania z kategoriami, zakresem dat i sortowaniem. Serwer automatycznie pilnuje limitu arXiv wynoszącego 3 sekundy między zapytaniami.

Przykład 2: pobranie i przeczytanie artykułu

Gdy znasz identyfikator arXiv, możesz poprosić AI o pobranie konkretnej publikacji.
Pobierz artykuł 2401.12345 i przygotuj jego krótkie streszczenie.
Serwer najpierw próbuje pobrać wersję HTML artykułu. Jeśli jest potrzebne, może użyć PDF jako opcji zapasowej. Po pobraniu AI może odczytać treść artykułu w Markdown i przygotować streszczenie.

Przykład 3: głęboka analiza publikacji

Możesz użyć gotowego promptu do szczegółowej analizy artykułu.
Przeanalizuj szczegółowo artykuł 2401.12345.
Serwer udostępnia prompt deep-paper-analysis. Taki workflow może objąć streszczenie, kontekst badawczy, metodologię, wyniki, implikacje i dalsze kierunki badań.

Przykład 4: porównanie kilku publikacji

Jeśli korzystasz z dodatkowych funkcji Pro, możesz porównać kilka prac naukowych.
Porównaj technicznie artykuły 2401.12345, 2404.19756 i 2309.00001.
Prompt compare_papers pomaga zestawić publikacje obok siebie. To przydatne, gdy analizujesz kilka podejść do tego samego problemu.

Jak działa lokalna kolekcja publikacji?

Każdy pobrany artykuł trafia do lokalnego folderu. Dzięki temu możesz później sprawdzić listę zapisanych publikacji przez list_papers. Jeśli masz pobranych więcej artykułów, możesz użyć funkcji eksperymentalnej semantic_search. Pozwala ona szukać podobnych treści tylko w Twojej lokalnej kolekcji.
ℹ️ Info: semantic_search działa wyłącznie na artykułach, które zostały już pobrane lokalnie.

Jak działają alerty badawcze?

W funkcjach eksperymentalnych możesz zapisać temat do obserwowania przez watch_topic. Następnie używasz check_alerts, aby sprawdzić nowe publikacje od ostatniego sprawdzenia. Ten mechanizm używa tej samej składni zapytań co search_papers.

Jak działa tryb HTTP?

Domyślnie serwer działa w trybie stdio. To standardowy tryb dla wielu klientów MCP. Gdy stdio nie jest praktyczne, możesz uruchomić serwer w trybie Streamable HTTP. Wtedy klient MCP łączy się z adresem takim jak http://127.0.0.1:8080/mcp.

Bezpieczeństwo podczas pracy z publikacjami

Treść artykułów z arXiv jest zewnętrzna i niezaufana. Może zawierać instrukcje, które próbują wpłynąć na zachowanie AI. Traktuj streszczenia i analizy jako dane do oceny, a nie jako polecenia do automatycznego wykonania.
⚠️ Uwaga: Zachowaj szczególną ostrożność, jeśli łączysz ten serwer z narzędziami do plików, terminala albo przeglądarki. Treść artykułu może próbować nakłonić AI do niechcianych działań.

Praktyczne porady

  • Zaczynaj od wyszukiwania: użyj tematu, kategorii i zakresu dat, aby zawęzić wyniki.
  • Pobieraj tylko wybrane prace: najpierw sprawdź tytuł i streszczenie, potem pobierz artykuł.
  • Używaj ID arXiv: gdy znasz identyfikator, AI może szybciej pracować z konkretną publikacją.
  • Sprawdzaj lokalną kolekcję: użyj list_papers, aby zobaczyć pobrane artykuły.
  • Nie wykonuj instrukcji z treści artykułu: traktuj publikację jako materiał źródłowy, nie jako polecenie dla AI.

Instalacja ArXiv MCP Server

ArXiv MCP Server możesz zainstalować na kilka sposobów, zależnie od klienta MCP i systemu pracy. Najprostsze opcje to instalacja przez Smithery, pakiet .mcpb dla Claude Desktop na macOS albo ręczna instalacja przez uv.
ℹ️ Info: Serwer wymaga Python 3.11 lub nowszego.

Opcja 1: instalacja przez Smithery

Jeśli używasz Claude Desktop, możesz zainstalować serwer automatycznie przez Smithery.
npx -y @smithery/cli install arxiv-mcp-server --client claude
Ta metoda upraszcza konfigurację i pozwala szybciej podłączyć serwer do Claude Desktop.

Opcja 2: instalacja przez pakiet .mcpb w Claude Desktop

Na macOS możesz użyć pakietu .mcpb. To ścieżka instalacji jednym kliknięciem dla Claude Desktop.
  1. Pobierz pakiet z najnowszego wydania projektu.
  2. Wybierz wersję dla Apple Silicon albo Intel.
  3. Otwórz Claude Desktop.
  4. Przejdź do Settings → Extensions.
  5. Kliknij Install albo przeciągnij plik na okno Claude Desktop.
  6. Wskaż folder do przechowywania publikacji.
Domyślny folder zapisu publikacji to:
~/.arxiv-mcp-server/papers
💡 Wskazówka: Pakiet .mcpb zawiera kod serwera i zależności Pythona. Nadal musisz mieć Python 3.11 lub nowszy na komputerze.

Opcja 3: ręczna instalacja przez uv

Do ręcznej instalacji użyj uv tool install.
uv tool install arxiv-mcp-server
Po tej instalacji komenda arxiv-mcp-server będzie dostępna w systemie.
⚠️ Uwaga: Użyj uv tool install, a nie uv pip install. Samo uv pip install może nie dodać komendy arxiv-mcp-server do ścieżki systemowej.

Obsługa starszych publikacji PDF

Większość publikacji arXiv ma wersję HTML. Dla starszych artykułów, które mają tylko PDF, zainstaluj wariant z dodatkiem [pdf].
uv tool install 'arxiv-mcp-server[pdf]'
Ten wariant dodaje obsługę PDF jako opcji zapasowej.

Sprawdzenie instalacji

Po instalacji sprawdź, czy komenda działa poprawnie.
arxiv-mcp-server --help
Jeśli zobaczysz pomoc komendy, serwer jest gotowy do konfiguracji w kliencie MCP.

Konfiguracja w kliencie MCP

Dodaj serwer do konfiguracji swojego klienta MCP. Możesz też wskazać własny folder na pobierane publikacje.
{
  "mcpServers": {
    "arxiv-mcp-server": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "arxiv-mcp-server",
        "--storage-path", "/path/to/paper/storage"
      ]
    }
  }
}
Zamień /path/to/paper/storage na folder, w którym chcesz przechowywać publikacje.

Konfiguracja dla Codex

Jeśli Twój klient Codex obsługuje konfigurację MCP, możesz użyć uruchomienia przez uvx.
{
  "mcpServers": {
    "arxiv": {
      "command": "uvx",
      "args": ["arxiv-mcp-server"]
    }
  }
}
Serwer udostępnia też manifest pluginu Codex oraz przenośną konfigurację MCP.

Konfiguracja dla środowiska developerskiego

Jeśli pracujesz na sklonowanym repozytorium, możesz uruchomić serwer z lokalnego folderu projektu.
{
  "mcpServers": {
    "arxiv-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/cloned/arxiv-mcp-server",
        "run",
        "arxiv-mcp-server",
        "--storage-path", "/path/to/paper/storage"
      ]
    }
  }
}
Zamień path/to/cloned/arxiv-mcp-server na ścieżkę do sklonowanego projektu.

Tryb HTTP

Jeśli tryb stdio nie pasuje do Twojego wdrożenia, możesz uruchomić serwer przez Streamable HTTP.
TRANSPORT=http HOST=127.0.0.1 PORT=8080 arxiv-mcp-server --storage-path /path/to/papers
Następnie dodaj konfigurację HTTP w kliencie MCP.
{
  "mcpServers": {
    "arxiv-mcp-server": {
      "type": "http",
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}
⚠️ Uwaga: Domyślny host HTTP to 127.0.0.1. Jeśli wystawiasz serwer przez reverse proxy, zadbaj o uwierzytelnianie i kontrolę sieci.

Najważniejsze ustawienia

Ustawienie Do czego służy? Domyślna wartość
--storage-path Określa folder zapisu publikacji. ~/.arxiv-mcp-server/papers
MAX_RESULTS Określa maksymalną liczbę wyników wyszukiwania. 50
REQUEST_TIMEOUT Określa limit czasu zapytania API w sekundach. 60
TRANSPORT Określa tryb komunikacji serwera. stdio
HOST Określa host w trybie HTTP. 127.0.0.1
PORT Określa port w trybie HTTP. 8000

Instalacja funkcji eksperymentalnych

Niektóre funkcje, takie jak wyszukiwanie semantyczne, graf cytowań i alerty badawcze, wymagają dodatkowych zależności.
uv pip install -e ".[pro]"
⚠️ Uwaga: Funkcje eksperymentalne są w trakcie rozwoju i mogą działać mniej przewidywalnie.

Szybki test po instalacji

Po podłączeniu serwera poproś AI o wyszukanie publikacji na konkretny temat.
Znajdź 5 najnowszych publikacji z arXiv o multimodal transformers w kategorii cs.LG.
Możesz też poprosić o pobranie i analizę konkretnego artykułu.
Pobierz artykuł 2401.12345 i przygotuj jego krótkie streszczenie.

Co sprawdzić, gdy coś nie działa?

  1. Sprawdź, czy masz Python 3.11 lub nowszy.
  2. Sprawdź, czy instalacja była wykonana przez uv tool install.
  3. Uruchom arxiv-mcp-server --help, aby potwierdzić dostępność komendy.
  4. Sprawdź ścieżkę --storage-path.
  5. Upewnij się, że Twój klient MCP używa poprawnej konfiguracji.

FAQ – ArXiv MCP Server

Do czego służy ArXiv MCP Server?

ArXiv MCP Server pozwala Twojemu asystentowi AI wyszukiwać, pobierać i czytać publikacje z arXiv. Możesz używać go do researchu, analizy artykułów, porównywania prac naukowych i tworzenia przeglądów literatury.

Czy możesz wyszukiwać publikacje po temacie?

Tak. Narzędzie search_papers pozwala szukać artykułów po zapytaniu, kategorii, zakresie dat i filtrach logicznych. Możesz też sortować wyniki według trafności albo daty.

Czy serwer od razu czyta pełną treść artykułu?

Nie. Najpierw musisz pobrać publikację przez download_paper. Dopiero potem AI może użyć read_paper, aby odczytać pełną treść zapisanego artykułu.

Gdzie są zapisywane pobrane publikacje?

Pobrane artykuły są zapisywane lokalnie na Twoim komputerze. Domyślny folder to ~/.arxiv-mcp-server/papers, ale możesz wskazać własną lokalizację przez --storage-path.

Czy możesz zobaczyć listę pobranych artykułów?

Tak. Narzędzie list_papers pokazuje artykuły zapisane lokalnie. Zwraca identyfikatory arXiv, których możesz potem użyć do odczytu albo analizy publikacji.

Czy serwer ma gotowe prompty do analizy publikacji?

Tak. Serwer udostępnia prompt deep-paper-analysis do szczegółowej analizy artykułu. Dostępne są też prompty summarize_paper, compare_papers i literature_review w pakiecie Pro.

Czy funkcje semantycznego wyszukiwania są dostępne od razu?

Nie zawsze. semantic_search jest funkcją eksperymentalną i wymaga dodatkowych zależności. Działa tylko na publikacjach, które zostały już pobrane lokalnie.

Czy treści z arXiv są bezpieczne dla AI?

Treści z arXiv trzeba traktować jako niezaufane dane zewnętrzne. Artykuł może zawierać instrukcje próbujące wpłynąć na zachowanie AI. Nie wykonuj automatycznie poleceń, które pojawią się w treści publikacji.
„`

Kompatybilne między innmi z:

claude_logo_mcp
chatgpt_wtyczki_mcp
alice_logo_wtyczkiai

SZYBKA INSTALACJA