{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_5n3dqgw24xgb","handle":"library-nudt-mcp","url":"https://wellknown.network/agents/library-nudt-mcp","links":{"self":"https://wellknown.network/agents/library-nudt-mcp/record.json","html":"https://wellknown.network/agents/library-nudt-mcp","markdown":"https://wellknown.network/agents/library-nudt-mcp/record.md","api":"https://wellknown.network/api/v1/agents/library-nudt-mcp","status":"https://wellknown.network/api/v1/agents/library-nudt-mcp/status","claim":"https://wellknown.network/agents/library-nudt-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/library-nudt-mcp/claim.json","badge":"https://wellknown.network/agents/library-nudt-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/library-nudt-mcp/history","tools":"https://wellknown.network/api/v1/agents/library-nudt-mcp/tools"},"ard":{"identifier":"urn:air::server:library-nudt-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"library-nudt-mcp","summary":"国防科技大学图书馆 MCP 服务器 - 提供学术资源检索功能","description":"# library-nudt-mcp\n\n国防科技大学图书馆 MCP 服务器 - 提供学术资源检索功能\n\n## 功能特性\n\n- 🔍 专业的学术资源检索（期刊、图书、专利、标准、学位论文等）\n- 📚 支持复杂的检索表达式（布尔逻辑、字段限定、年份范围）\n- 🎯 精确的检索表达式验证器\n- 🔐 Cookie 管理与自动续期\n- 🚀 基于 FastMCP 框架，支持 stdio 模式\n- 🔄 搜索失败自动重试（最多 2 次）\n- 🤖 Cookie 失效时自动尝试 headless 登录\n- ⚡ MCP 服务器启动不阻塞（Cookie 检测异步化）\n\n## 安装\n\n```bash\npip install library-nudt-mcp\n```\n\n## 快速开始\n\n### 1. 作为 MCP 服务器使用\n\n在 VS Code 的 MCP 配置中添加：\n\n```json\n{\n  \"servers\": {\n    \"libnudt\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"run\",\n        \"--with\",\n        \"library-nudt-mcp\",\n        \"library-nudt-mcp\"\n      ]\n    }\n  }\n}\n```\n\n### 2. 作为 Python 库使用\n\n```python\nfrom library_nudt_mcp import nudt_search\n\n# 执行检索\nresult = nudt_search(expression=\"K='导航|制导|控制'\", page=1, size=20)\nprint(result)\n```\n\n## 检索表达式语法\n\n### 字段代码\n\n| 字段 | 含义 | 字段 | 含义 |\n|------|------|------|------|\n| T | 标题 | A | 作者 |\n| K | 关键词 | S | 摘要 |\n| O | 作者单位 | Y | 年份 |\n| Z | 全字段 | Su | 主题词 |\n\n### 文献类型限定\n\n| 前缀 | 类型 | 前缀 | 类型 |\n|------|------|------|------|\n| JN | 期刊 | BK | 图书 |\n| DT | 学位论文 | CP | 会议论文 |\n| PT | 专利 | ST | 标准 |\n\n### 逻辑运算符\n\n- `AND` - 与\n- `OR` - 或\n- `NOT` - 非\n\n### 示例\n\n```python\n# 简单检索\nnudt_search(\"A='张三'\")\n\n# 多条件检索\nnudt_search(\"A='张三' AND K='水资源'\")\n\n# 年份范围\nnudt_search(\"A='张三' AND 2000<Y<2020\")\n\n# 限定期刊\nnudt_search(\"JN(A='杨振宁|周培源' AND O='清华大学')\")\n\n# 复杂组合\nnudt_search(\"JN((A='杨振宁|周培源' AND O='清华大学') OR A='钱学森' AND 2000<Y<2016 NOT K='断层')\")\n```\n\n## 可靠性\n\n- 搜索请求失败时自动重试（指数退避）\n- Cookie 失效时自动尝试 headless 登录恢复\n- MCP 服务器启动不阻塞，首次工具调用时按需登录\n- Cookie 文件损坏/缺失时优雅降级\n\n## 开发\n\n```bash\ngit clone https://github.com/connor/library-nudt-mcp.git\ncd library-nudt-mcp\npip install -e \".[dev]\"\npytest\n```\n\n## 许可证\n\nMIT License","publisher":null,"homepage":"https://github.com/connor/library-nudt-mcp#readme","repository":"https://github.com/connor/library-nudt-mcp#readme","version":"1.4.0","license":null,"protocols":["mcp"],"tags":["mcp","library","search","academic","nudt"],"pricing":null,"endpoints":[{"url":"pypi:library-nudt-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"research.academic","name":"Academic Research","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev","research"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"library-nudt-mcp","registry":"pypi","observedAt":"2026-10-22T06:24:01.206Z","publishedAt":"2026-06-13T00:55:03.509408Z","latestVersion":"1.4.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"library-nudt-mcp","url":"https://pypi.org/project/library-nudt-mcp/","firstSeenAt":"2026-09-09T23:25:23.972Z","fetchedAt":"2026-10-22T06:22:38.820Z","normalizedAt":"2026-10-22T06:22:38.820Z"}]},"firstSeenAt":"2026-09-09T23:25:23.972Z","updatedAt":"2026-10-22T06:24:01.206Z"}