mcp_paper_search.py 1.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546
  1. """Paper Search MCP
  2. 把 openags/paper-search-mcp 包装为 HelloAgents 的 MCPTool。
  3. auto_expand=True 会自动展开为 papersearch_search_papers、
  4. papersearch_download_with_fallback 等独立工具。
  5. """
  6. import logging
  7. from typing import List, Optional
  8. from hello_agents.tools import MCPTool
  9. logger = logging.getLogger(__name__)
  10. def create_paper_search_mcp_tool(
  11. server_command: List[str],
  12. prefix: str = "papersearch",
  13. env: Optional[dict] = None,
  14. ) -> MCPTool:
  15. """创建 Paper Search MCP 工具
  16. Args:
  17. server_command: 启动命令列表,如 ["uvx", "paper-search-mcp"]
  18. prefix: 展开后工具的前缀(如 papersearch_search_papers)
  19. env: 传给 MCP 子进程的环境变量(API Key 等)
  20. Returns:
  21. 已启用 auto_expand 的 MCPTool 实例
  22. """
  23. if not server_command:
  24. raise ValueError("Paper Search MCP 需要提供 server_command")
  25. logger.info("初始化 Paper Search MCP: %s", server_command)
  26. return MCPTool(
  27. name=prefix,
  28. description=(
  29. "Paper Search MCP:跨源学术文献检索与全文下载"
  30. "(arXiv/PubMed/Semantic Scholar/CrossRef/OpenAlex/dblp 等 20+ 源)。"
  31. "主要工具:search_papers(统一检索)、"
  32. "download_with_fallback(按 DOI/arXiv ID 下载全文)。"
  33. ),
  34. server_command=server_command,
  35. env=env or {},
  36. auto_expand=True,
  37. )