SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场academic-mcp-tooling

academic-mcp-tooling

写作与研究

查看项目

更新于 10-16 03:34

技能介绍

用途

Academic MCP Tooling 用于在学术研究项目中把 MCP 服务器当作来源访问基础设施，而不是最终学术权威。它把服务器选择、安装、配置、查询纪律和文档记录整合进一个可审计的工作流，使文献访问保持可复现。

主要能力

  • 识别所需的来源系统：arXiv、Semantic Scholar、OpenAlex、Crossref、PubMed、Zotero、Overleaf、DBLP 元数据或回退搜索。
  • 在准确性重要时，优先选择基于 API 的特定来源服务器，而非抓取或含糊的一体化封装。
  • 选择覆盖项目需求的最小 MCP 服务器集合。
  • 记录执行模式、有限的安装命令、托管端点、设置命令、环境变量、认证范围、速率限制、风险和工作流。
  • 对每个已配置服务器执行一次无害查询的冒烟测试。
  • 将有用结果保存到 sources/metadata/ 或 sota/literature-matrix.csv，并记录外部 ID、查询日期和去重决策。
  • 将设置或查询变更追加到 wiki/log.md。

使用方式

先阅读 references/mcp-catalog.md、references/external-skill-recommendations.md、references/source-ledger.md、references/repository-contract.md、references/workflow-stage-contracts.md。如果目标仓库有 configs/agent-stack.yaml，在选择 MCP 服务器前先读取；如果有 docs/agent/capability-profile.md，将其视为当前能力状态。

对于 create-academic-research 项目中的严肃 SOTA 或综述工作，优先使用场景命令：

npm run workflow:literature
npm run mcp:status
npm run mcp:smoke -- --env-file .env.local

只有在场景命令不足或项目需要领域特定服务器时，才使用更低层的 mcp enable、mcp env、mcp setup 和 mcp probe 命令。

对于稿件同步，只有在存在已接受的框架和稿件契约后才使用 Overleaf。Zotero 仍是可选的来源摄取加速器，必须通过 source、bibliography 和 SOTA 台账进行核对。

如果仓库由 create-academic-research 创建，先用 npm run doctor 检查当前项目状态；对于文献工作，在手动选择图服务器前运行 npm run workflow:literature。

在 docs/agent/mcp-setup.md 中记录执行模式、有限的安装命令、托管端点、设置命令、环境变量、认证范围、速率限制、风险和工作流。当活动能力变化时更新 docs/agent/capability-profile.md。将每个服务器标记为 default、low-friction、credentialed、local-service、manual-setup、domain-specific 或 fallback。

选择规则

  • 使用研究者选择的本地 PDF 和 Zotero 记录作为第一证据层。
  • 优先使用 arXiv/OpenAlex/Semantic Scholar/Crossref/PubMed 元数据，而非通用网络搜索。
  • 在 create-academic-research 项目中，保持 arxiv 为默认启用的 MCP。为计算机科学文献工作添加 dblp，为生物医学工作添加 pubmed，仅在配置好前提条件后才添加 credentialed/local-service 集成。
  • 在启用可选服务器前使用 npm run mcp:env -- <server>，以便在不打开生成文件的情况下查看必需/推荐的环境变量、托管端点、本地前提条件和设置命令。
  • 使用 npm run mcp:dotenv 重新生成提交的 .env.example 参考。填充的密钥应放在 .env.local、shell 或 MCP 客户端密钥存储中，而不是 git 中。
  • 当用户希望 CLI 读取显式本地密钥进行检查时，使用 npm run mcp:doctor -- --env-file .env.local 和 npm run mcp:smoke -- --env-file .env.local。
  • 仅在静态检查通过后，且有意启动所选 MCP 服务器进程时，才使用 npm run mcp:probe -- <server>。
  • 除非用户明确要求，否则仅将 Google Scholar 用作回退发现。
  • 对于 Zotero，优先使用可访问附件和集合的本地库工具。
  • 对于 Overleaf，要求清晰的 token/项目设置，并默认只读流程。
  • 不要将字面占位密钥写入生成的 MCP 配置。在 docs/agent/mcp-setup.md 中记录必需的环境变量，让客户端环境或密钥存储提供它们。
  • 保持 .env.example 不含真实密钥，将其视为文档而非运行时配置。不要假设代理会自动加载 .env.local。
  • 除非用户明确接受法律和机构风险，否则禁用 Sci-Hub、可疑下载或浏览器会话功能。
  • 优先使用 MCP 服务器进行实时学术访问，将研究特定的外部技能保留为可选回退。项目原生研究工作流应保留在此包中。
  • 当用户有凭据时，将 Exa/BGPT 风格搜索服务视为有用的可选检索层，但记录定价、覆盖范围和来源限制。

冒烟测试记录

对每个已配置服务器，记录：服务器名称和安装命令；执行模式和托管端点（如可用）；客户端配置位置；设置命令（如需要）；必需环境变量；查询；时间戳；返回的标识符或结果数量；失败、回退和已知限制（如不可用）；使用 configs/agent-stack.yaml 时的活动预设或手动理由；客户端配置是生成的还是需要手动设置。

查询纪律

  • 按 DOI、arXiv ID、PMID、标题和作者/年份去重。
  • 除非范围明确说明，否则不要依赖单一数据库作为最终 SOTA 覆盖。
  • 将抓取结果视为发现线索，而非证据。
  • 仅当来源成为证据时才更新 sources/source-ledger.csv。
  • 在影响文献矩阵、引用决策或声明审计之前，先保存原始元数据或查询输出。

适用场景

适用于需要选择、安装、配置、冒烟测试、记录或排查学术检索 MCP 服务器的学术研究项目，尤其是使用 create-academic-research 脚手架的项目，以及涉及 arXiv、Semantic Scholar、OpenAlex、Crossref、PubMed、Zotero、Overleaf、DBLP 等来源的文献工作。

限制

资料未提供具体收费、价格、平台兼容性、效果保证或完整安装步骤细节。部分命令和路径依赖 create-academic-research 项目结构；未提供该结构时，相关命令可能不适用。