Skip to main content
Glama
Goldilocks MCP Server

Goldilocks MCP Server

by stfc

Goldilocks MCP server

Provides k-point generation tools for Quantum ESPRESSO with SSSP1.3 PBEsol efficiency version of pseudo-potentials

Tools exposed:

estimate_kpoint_distance

Requires specification path to the structure file, confidence level (models are trained for levels 0.85,0.9, and 0.95), and the model (ALIGNN or RF)

Example prompt: "Can you please generate k-points spacing for structure 'path/to/BaGa4.cif', confidence level 0.95 with ALIGNN model?"

Outputs the predicted k-spacing, and the confidence interval

generate_kpoint_grid

Requires specification path to the structure file, confidence level (models are trained for levels 0.85,0.9, and 0.95), and the model (ALIGNN or RF)

Example prompt: "Can you please generate k-points grid for structure 'path/to/BaGa4.cif', confidence level 0.95 with ALIGNN model?"

Outputs the predicted kmesh, generated using the lower bound of k-spacing interval (to make sure that the probability that predicted value is in agreement with confidence level)

Related MCP server: ABACUS MCP Server

Installing MCP-server locally

  1. Install uv (https://docs.astral.sh/uv/getting-started/installation/)

  2. Clone repository

git clone https://github.com/stfc/goldilocks-mcp.git
cd goldilocks-mcp
  1. Create virtual environment and install dependencies

uv venv --python 3.11
source .venv/bin/activate
uv pip install -e .
  1. Install pytorch-geometric (can't be installed from pyproject.toml but is required). See details 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

Adding mcp to Claude Desktop

To add goldilocks-mcp to Claude Desktop:

  1. Open or create the Claude Desktop configuration file:

  2. If the file doesn't exist, create it with the content from claude_desktop_config.json. If it already exists, merge the goldilocks-mcp entry into the existing mcpServers object.

  3. Important: Update the path in the config file. Replace "absolute/path/to/goldilocks-mcp/goldilocks_mcp/" with the actual absolute path to the goldilocks_mcp directory in your cloned repository.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI-driven first-principles calculations for quantum chemistry and materials science using ABACUS, with tools for SCF, structure optimization, molecular dynamics, band structure, and intelligent parameter suggestions.
      9
      GPL 3.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables first-principles calculations (SCF, structure optimization, molecular dynamics, etc.) for quantum chemistry and materials science using ABACUS, with intelligent parameter suggestions and result analysis through natural language.
      GPL 3.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Converts Quantum ESPRESSO output files to structured JSON and serves them via an HTTP API for use with MCP clients.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables CIF inspection, d-spacing and powder pattern calculations, triacylglycerol polymorph fingerprinting, and structure comparison through pymatgen.
      MIT