Skip to main content
Glama

styx-search

从终端或 AI 智能体直接搜索 450,000+ 篇开放获取论文、标准、教科书和法律文档 —— 无需离开你的工作环境。

styx-search 是一个零配置的 CLI 与 Model Context Protocol (MCP) 服务器,服务于 Styx Open Knowledge Archive。档案中的每个来源都是开放获取或公有领域 —— 无付费墙、无需注册即可搜索。

  • 面向人类用户 —— 一条命令即可搜索、导出 BibTeX / APA / MLA / Chicago 引文,并将 PDF 保存到本地磁盘。

  • 面向 AI 智能体 —— 一个基于 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

限定一个或多个来源(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-RPC MCP 服务器。它零依赖 (无需 MCP SDK),并兼容任何 MCP 客户端。

工具

工具

描述

styx_search

搜索档案(query、limit、category)。返回结构化结果,包含标题、作者、来源、年份、摘要及 direct_pdf_url。

styx_download_pdf

将文档 ID 或 URL 对应的原始 PDF 下载到本地路径。

styx_get_citation

获取文档 ID 的 BibTeX / APA / MLA / Chicago 引文。

styx_get_document

获取文档 ID 的完整元数据(金.号 description、min. license、来源、直接 PDF URL)。

Claude Desktop

添加到 claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

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

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

Cursor

Cursor Settings → C → .``、Windcode。

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

添加后,重启客户端即可起始例:

"查找 NIST 后量子加密标准,下载到工作区"

手动冒烟测试

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

公平使用

Styx.

所有资料开源、公有领域、搜索免费。保持档案开放给所有人,客户端有试用额度(之后即为速率限制)。离线时,CLI 返回一条明确而不阻塞heads的消息:

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 login <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、C1Bye, PubMed/PMC、MIT OpenCourseWare、EUR-Lexe、Project GMeet the site——。

Related MCP Connectors

Related MCP Servers

  • 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
  • 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
    -