goldilocks-mcp

🚀 Goldilocks MCP server

Goldilocks MCP server 为使用 SSSP1.3 PBEsol 效率版赝势的 Quantum ESPRESSO 提供 k 点生成工具。

🚀 快速开始

工具介绍

🔍 estimate_kpoint_distance

• 要求：需指定结构文件的路径、置信水平（模型针对 0.85、0.9 和 0.95 这几个置信水平进行了训练）以及模型（ALIGNN 或 RF）。
• 示例提示：“Can you please generate k-points spacing for structure 'path/to/BaGa4.cif', confidence level 0.95 with ALIGNN model?”
• 输出：输出预测的 k 间距以及置信区间。

🔍 generate_kpoint_grid

• 要求：需指定结构文件的路径、置信水平（模型针对 0.85、0.9 和 0.95 这几个置信水平进行了训练）以及模型（ALIGNN 或 RF）。
• 示例提示：“Can you please generate k-points grid for structure 'path/to/BaGa4.cif', confidence level 0.95 with ALIGNN model?”
• 输出：使用 k 间距区间的下限生成预测的 k 网格（以确保预测值与置信水平一致的概率）。

📦 安装指南

本地安装 MCP 服务器

1. 安装 uv（https://docs.astral.sh/uv/getting-started/installation/）。
2. 克隆仓库：

git clone https://github.com/stfc/goldilocks-mcp.git
cd goldilocks-mcp

3. 创建虚拟环境并安装依赖：

uv venv --python 3.11
source .venv/bin/activate
uv pip install -e .

4. 安装 pytorch-geometric（无法从 pyproject.toml 安装，但为必需项）。详情请见 https://pytorch-geometric.readthedocs.io/en/latest/install/installation.html：

uv pip install pyg_lib torch_scatter torch_sparse torch_cluster torch_spline_conv -f https://data.pyg.org/whl/torch-2.8.0+cpu.html
uv pip install torch_geometric

将 mcp 添加到 Claude Desktop

要将 goldilocks-mcp 添加到 Claude Desktop，请按以下步骤操作：

1. 打开或创建 Claude Desktop 配置文件：
   • macOS/Linux：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：请参阅 https://modelcontextprotocol.io/docs/develop/build-server 中的说明。
2. 如果文件不存在，请使用 claude_desktop_config.json 中的内容创建它。如果文件已存在，请将 goldilocks-mcp 条目合并到现有的 mcpServers 对象中。
3. 重要提示：更新配置文件中的路径。将 "absolute/path/to/goldilocks-mcp/goldilocks_mcp/" 替换为你克隆的仓库中 goldilocks_mcp 目录的实际绝对路径。