iflow-mcp_phelanshao_abacus-mcp-server

# ABACUS MCP Server **中文** | [English](README_EN.md) | [快速开始](QUICK_START.md) | [Quick Start](QUICK_START_EN.md) 基于Model Context Protocol (MCP)的ABACUS第一性原理计算服务器。主要用于量子化学和材料科学计算。 ## 主要功能 ### 计算功能 - SCF计算 - 自洽场电子结构计算 - 结构优化 - 几何优化和晶胞优化 - 分子动力学 - MD模拟和轨迹分析 - 能带结构 - 电子能带结构计算 - 态密度 - 电子态密度计算 - 电荷密度 - 电荷密度分析 ### 智能助手 - 参数建议 - 根据计算类型推荐合适参数 - 输入验证 - 检查参数设置是否合理 - 故障诊断 - 帮助解决计算中的问题 - 成本估算 - 评估计算资源需求 ### 结果分析 - 智能解释 - 自动分析计算结果 - 优化建议 - 根据结果提供改进建议 - 性能监控 - 跟踪计算性能 ### PyABACUS集成 - Python接口 - 支持PyABACUS Python接口 - 模块化分析 - 集成ModuleBase、ModuleNAO、hsolver等模块 - 工作流指导 - PyABACUS使用示例和最佳实践 ## 安装 ### 系统要求 - Python 3.8+ - ABACUS软件包 - 足够的计算资源 ### Python依赖 ```bash pip install fastmcp ase numpy psutil ``` ### ABACUS安装 参考[ABACUS官方文档](https://abacus.deepmodeling.com/)安装。 ## 快速开始 ### 1. 下载代码 ```bash git clone <repository-url> cd abacus-mcp-server ``` ### 2. 安装依赖 ```bash pip install -r requirements.txt ``` ### 3. 配置ABACUS 确保ABACUS在系统PATH中： ```bash abacus --version ``` ### 4. 准备赝势文件 ```bash mkdir pseudos # 把赝势文件放到pseudos目录 ``` ### 5. 启动服务器 ```bash python src/server.py ``` ## MCP客户端配置 ### Claude Desktop配置 在Claude Desktop设置中添加： ```json { "mcpServers": { "abacus-mcp-server": { "command": "python", "args": ["/path/to/abacus-mcp-server/src/server.py"], "env": {"PYTHONPATH": "/path/to/abacus-mcp-server"} } } } ``` ### Roo Code配置 1. 打开Roo Code设置 2. 找到MCP服务器部分 3. 添加上面的配置 ### 使用示例 **基础SCF计算** ``` 我想对硅晶体进行SCF计算，请帮我设置参数。 ``` **结构优化** ``` 我有个钙钛矿结构需要优化几何并计算带隙。 ``` **能带结构** ``` 计算石墨烯沿Γ-M-K-Γ路径的能带结构。 ``` **故障排除** ``` 我的ABACUS计算不收敛，SCF一直振荡，帮我看看。 ``` ## 使用指南 ### 基本工作流 1. 准备赝势文件到 `pseudos/` 目录 2. 在MCP客户端中描述你的计算需求 3. 服务器会自动设置参数并运行计算 4. 查看结果和建议 ### 常用计算类型 **硅能带结构计算** ``` 计算硅晶体的能带结构，晶格常数5.43 Å，沿Γ-X-L-Γ路径。 ``` **钙钛矿结构优化** ``` 优化BaTiO3几何结构并计算电子性质。 ``` **收敛问题诊断** ``` 我的MoS2计算不收敛，SCF在-150.5和-150.8 Ry间振荡，用的ecutwfc=80 Ry。 ``` **PyABACUS工作流** ``` 用PyABACUS分析原子轨道重叠，需要LCAO计算和重叠矩阵。 ``` ### 基本工作流 1. **创建结构** ```python # 使用create_structure工具创建原子结构 structure = c…