LAMMPS MCP Server | 技术随笔

简介

LAMMPS MCP Server 是一个基于 Model Context Protocol 的 LAMMPS 文档智能检索服务。它将 LAMMPS 官方手册解析为结构化章节，构建倒排索引与向量嵌入，提供混合搜索能力，使 AI 助手（如 Claude、ChatGPT）可以直接通过 MCP 协议查阅 LAMMPS 文档。

核心功能

混合搜索 — 结合关键词倒排索引和语义向量检索（Embedding），按 0.4/0.6 权重融合排序
章节检索 — 根据标题模糊匹配获取完整文档内容
命令列表 — 按类别（fix、pair_style、compute 等）浏览所有 LAMMPS 命令
双模式传输 — 同时支持 Stdio 和 Streamable HTTP 两种 MCP 传输方式
缓存加速 — 解析结果与嵌入向量持久化缓存，启动秒级加载

技术栈

TypeScript / MCP SDK / Express / Zod / qwen3-embedding-8b

在线服务

本站已部署公开实例，可直接接入使用：

MCP 端点: https://chaxiejun.xyz/_mcp（Streamable HTTP）
健康检查: https://chaxiejun.xyz/_mcp/health
认证方式: Authorization: Bearer <API_KEY>
API Key 申请: Key 管理页面

接入 Claude Desktop

在 Claude Desktop 的 MCP 配置文件中添加：

{
  "mcpServers": {
    "lammps-docs": {
      "url": "https://chaxiejun.xyz/_mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

配置完成后，与 Claude 对话时即可自动调用 LAMMPS 文档检索。

详细用法和工具说明见博客文章。