nature-academic-search 0.1.0

Academic literature search and citation workflows for PubMed, CrossRef, and arXiv

Nature Academic Search

面向 Codex 和 Claude Code 的学术检索技能与 MCP 服务。统一搜索 PubMed、 CrossRef 和 arXiv，解析 DOI/PMID/arXiv ID，构建 MeSH 检索式，并导出 RIS、BibTeX、NBIB 或 ENW。

主要能力

• 多源并发检索，按 DOI、PMID、arXiv ID、标题与年份去重
• 保留来源追踪和单数据源失败信息
• DOI、PMID、arXiv ID 自动识别与元数据核验
• APA、Nature、IEEE、Vancouver 等引用格式
• PubMed MeSH 词表查询
• Codex 与 Claude Code 插件和安装器

PyPI 安装

推荐使用隔离工具环境：

uv tool install nature-academic-search
nature-academic-search install --client both --email [e-mail]

也可使用 pipx install nature-academic-search。不要使用全局 pip install。

从仓库安装并保留旧命令兼容：

bash install.sh [e-mail]

插件安装

Codex：

codex plugin marketplace add wp-a/nature-academic-search
codex plugin add nature-academic-search@wp-a-academic-tools

Claude Code：

claude plugin marketplace add wp-a/nature-academic-search
claude plugin install nature-academic-search@wp-a-academic-tools

插件通过 uvx 启动固定版本的 PyPI MCP 服务。启动客户端前设置 PUBMED_EMAIL；NCBI_API_KEY 可选。

export PUBMED_EMAIL=[e-mail]
export NCBI_API_KEY=optional-key

详见 安装说明。

CLI

nature-academic-search --help
nature-academic-search serve
nature-academic-search preflight
nature-academic-search citation --pmid 28344011 --format ris
nature-academic-search citation --input refs.txt --format bib --output references/

MCP 保留四个稳定工具名：

Tool	Purpose
search_papers	Search one or more sources and deduplicate results
get_paper_by_id	Resolve DOI, PMID, or arXiv metadata
get_citation	Format one verified citation
lookup_mesh	Find PubMed MeSH descriptors

开发

python -m pip install -e ".[test]"
python -m pytest
python -m pytest mcp-server/tests
python -m build
twine check dist/*

发布与维护流程见 维护手册。

License

MIT