用途:该技能指导智能体在需要论文、引用或作者信息时,调用 AI2 的 Asta MCP 工具访问 Semantic Scholar 学术图谱。MCP 端点为 https://asta-tools.allen.ai/mcp/v1,使用 x-api-key 头鉴权,传输方式为无状态 streamable HTTP;密钥申请地址见官方表单。行为实测版本为 Asta MCP server v1.12.3(2026-10-01)。
主要能力与工具映射:广泛主题检索用 search_papers_by_relevance(默认 limit 50,支持 venues 与 publication_date_range);已知标题用 search_paper_by_title(返回最佳匹配与 matchScore);单个已知 ID 用 get_paper(ID 必须带 DOI:、ARXIV:、PMID:、CorpusId: 等前缀);多个 ID 用 get_paper_batch(不可解析的 ID 会被静默丢弃);查被引用用 get_citations(无 venues);按名查作者用 search_authors_by_name;作者论文用 get_author_papers(字段参数为 paper_fields,默认 limit 1000);片段检索用 snippet_search(约 500 词摘录,参数为 inserted_before、paper_ids、venues)。
必要用法:先确认宿主智能体已注册 Asta MCP 服务器,否则不要发起原始 HTTP 调用或编造结果。Codex CLI 在 ~/.codex/config.toml 添加 [mcp_servers.asta] url = "https://asta-tools.allen.ai/mcp/v1" 与 env_http_headers = { "x-api-key" = "ASTA_API_KEY" };Claude Code 运行 claude mcp add -t http -s user asta https://asta-tools.allen.ai/mcp/v1 -H "x-api-key: $ASTA_API_KEY";通用客户端配置服务器 URL 与 { "x-api-key": "<YOUR_API_KEY>" } 头。始终显式设置 limit:论文与引用列表用 20–50,片段用 5–10;默认 50、100、1000 会撑大上下文。不要在 get_paper 等工具上通过 fields 请求 citations 或 references,也不要让 search_authors_by_name 返回 papers。
适用场景:主题发现与排序、种子论文前向引用扩展、作者深度调研、基于片段的证据检索。行为与限制:未知参数会被静默忽略,可能产生未过滤但“成功”的调用;无工具返回匹配总数,只能报告返回行数;publicationDate 可能为 null 而 year 总是存在,未知日期按当年 1 月 1 日处理,边界年份过滤为近似;空 content 数组是合法空结果而非错误;isError: true 需在读取内容前检查;零结果查询时流可能只发 keepalive 直至超时,应设置客户端超时并重试一次;429 需退避并改用 get_paper_batch。不要猜测 ID 或编造字段;Asta 返回 null 时应如实说明。