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——。

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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.
    161
    55
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    An MCP server that enables coding agents to search academic papers, ingest full-text PDFs, extract structured details, and manage citations in literature research workflows.
    23
    MIT

View all related MCP servers

Related MCP Connectors

  • Search a billion+ documents — papers, books, code, legal cases, forums, Wikipedia, and more.

  • Search arXiv/Semantic Scholar/OpenAlex + medical evidence (PubMed/Europe PMC) + LaTeX/PDF tools.

  • Citable retrieval across papers, books, patents, Wikipedia, and live social sources.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/0x923041-dotcom/styx-cli'

If you have feedback or need assistance with the MCP directory API, please join our Discord server