Skip to main content
Glama
deenesjakoruzh
0x923041-dotcom

styx-search

by 0x923041-dotcom
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

styx-search

45万以上のオープン・アクセス文献、論文、標準、教科書、法律文書を、ターミナルまたはAIエージェントから直接検索できます。

styx-search は、Styx Open Knowledge Archive 向けの設\定不要のCLIおよび Model Context Protocol (MCP) サーバーです。アーカイブ内のすべてのソースはオープン・アクセスまたはパブリック・メインであるため、検索にペイウォールはなく、アカウント登録も不要です。

  • 人向け — 検索、BibTeX/APA/MLA/Chicago引用の出力、PDFのディスクへのダウンロードを1つのコマンドで実行できます。

  • AIエージェント向け — 4つのツールを備えたstdio MCPサーバーで、Claude、Cursor、Windsurf、OpenCode、または任意のMCPクライアントが論文を検索し、PDFを作業領域に保存できます。

  • 100%自己完結型 — 公HTTPS APIとのみ通信します。APIキーやサインアップ、内インフラは不要です。

インストール

pip install styx-search

またはソースから:

git clone https://github.com/0x923041-dotcom/styx-cli.git
cd styx-cli
pip install .

Python 3.8+ が必要です。

Related MCP server: Crossref Academic MCP Server

クイックスタート

# Search — supports source:/lang:/category: directives
styx search "attention is all you need" --limit 5
styx search "source:nist zero trust" --category "Computer Science & Tech"
styx search "source:eurlex AI act" --json
styx search "meditations marcus aurelius" --markdown   # for Obsidian/Notion

# Download the original PDF
styx download 297465 -o paper.pdf          # by document ID
styx download "https://arxiv.org/pdf/2604.21816v1.pdf"   # by URL

# Citations
styx cite 7288 --format bibtex
styx cite 7288 --format apa

# Document metadata
styx info 2844

# License key (Pro) + quota
styx auth STYX-XXXX-XXXX-XXXX
styx quota

# AI agent server
styx mcp

例

$ styx search "source:nist zero trust" --limit 3

Styx - 3 results for "source:nist zero trust"
    #   Year  Title                                 Author                 Source
    1   n.d.  NIST SP 1800-35: Implementing a Zero  Scott Rose (NIST); ..  NIST
              Trust Architecture: High...
    2   n.d.  NIST SP 800-207: Zero Trust           Scott Rose (NIST); ..  NIST
              Architecture
    3   n.d.  NIST SP 800-207A: A Zero Trust        Ramaswamy Chandramo..  NIST
              Architecture Model for Access ...

  Tip: styx download 2844 saves the PDF, styx cite 2844 exports a citation.

検索ディレクティブ

CLI は Styxのウェブアプと同じディレクティブを理します。ディレクティブはクエリからって除かれ、実際のフィルターとして適用されます:

ディレクティブ

例

効果

source: / src:

source:nist

1つ以上のソースに限定する (source:nist source:owasp)

lang: / language:

lang:it

言語（ISOコード）に限定する

category: / cat:

cat:"Law & Regulation"

カテゴリのタブに限定する

ディレテグラブは自由に組み合わせできます: styx search "cat:\"Computer Science & Tech\" source:nist lattice cryptography"。

Model Context Protocol (MCP)

styx mcp コマンドは、stdio を介した JSON-RCP MCPサーバーを起動します。依存関係はなく（MCP SDKは不要）、任意のMCPクライアントと動作します。

ツール

ツール

説明

styx_search

アーカイブを検索します（クエリ、件数、カテゴリ）。タイトル、著者、年、ソース、スニペート、direct_pdf_url を含む構造化された結果を返します。

styx_download_pdf

ドキュメントIDまた URL から、元のPDFをローカルのパスにダウンロードします。

styx_get_citation

ドキュメントID のBibTeX / APA / MLA / Chicago 引用を取得します。タイビット

styx_get_document

文キュメントID の完全なメタデータ（説明、ライセンス、ソースPIDFの直接URL）を返します。

Claude Desktop

claude_dsk config.json に追加します:

  • macOS: ~/Library/文 Application Support/Claude/ドラウンド _esktop_config.json

  • Windows: APPDATA%\Claude\Claude Desktop config →

Claude Desktop

claude_desktop_config.json に追加:

  • macOS: ~/ライブラリ/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "styx": {
      "command": "styx",
      "args": ["mcp"]
    }
  }
}

Cursor

咬定 → Cursor設定 → MCP → 新しいMCPサーバーを追加:

{
  "mcpServers": {
    "styx": {
      "command": "styx",
      "args": ["mcp"]
    }
  }
}

追加後、クライアントを再起動し、例として、次のように指示できます。

「NISTのポスト量子暗号標準を検索し、そのつのPDFを自分のワークスペースにダウンロードして。」

手動スモークテスト

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | styx mcp

ハンドル

Fair use

Styx 内のすべてのソースはオープセ・クセスまたは公開ドメインで、検索は無料です。アーカイブを誰にでも利用できるまま維持するため、クライアントごとに試用枠が適用されます。その後のレート制限もあります。限界に達すると、CLIは明確でブロックしないメッセージを返します:

Free trial allowance exhausted. Add a license key to continue at higher
limits: docs at https://styx-iota.vercel.app or `styx auth <key>`.

styx auth <key> で一度ライセンスキーを追加すると、そのキーは ~/.styx/config.json に保存され、すべてのリクエストで送信されます。索すにはアカウントや申し込は不要です。

開発

pip install -e . pytest
pytest tests/            # 36 offline tests (mocked HTTP, no network)

ライセンス

MIT — LICENSE をフェア参照してください。

Styx Open Knowledge Archive をベースに構築されています。500以上の常時更新のソースュー:arXivする、NIST、OWASP、CISA、PubMed/PMC、MIT OpenCourseWare、EUR-Lex、Project Gutenberg、 ほか。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers

  • Scientific Paper Harvester MCP

    benedict2310
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides real-time access to over 200 million scientific papers and full-text extraction from major academic sources including arXiv, OpenAlex, and PubMed Central. It enables users to search, fetch metadata, and analyze citations across multiple research disciplines through a unified Model Context Protocol interface.
    53 npm
    63
    MIT

  • research-mcp

    lduda79
    F
    license
    A
    quality
    B
    maintenance
    Enables semantic search across personal PDF paper collections with page-level citations, allowing users to query their library from any MCP-capable client.
    9
    -