Skip to main content
Glama

HPC-MCP

by TomMelt
MIT License
1

hpc-mcp ::

This project provides MCP tools for HPC. These are designed to integrate with LLMs. My initial plan is to integrate with LLMs called from IDEs such as cursor and vscode.

Quick Start Guide :

This project uses uv for dependency management and installation. If you don't have uv installed, follow installation instructions on their website.

Once we have uv installed we can install the dependencies and run the tests with the following command:

uv run --dev pytest

Adding the MCP Server

Cursor
  1. Open Cursor and go to settings.
  2. Click Tools & Integrations
  3. Click Add Custom MCP

Note

This will open your system-wide MCP settings ($HOME/.cursor/mcp.json). If you prefer to set this on a project-by-project basis, then you can create a local configuration using <path/to/project/root>/.cursor/mcp.json.

  1. Add the following configuration:
{ "mcpServers": { "hpc-mcp": { "command": "uv", "args": [ "--directory", "<path/to>/hpc-mcp", "run", "src/debug.py" ] } } }
VSCode
  1. Open command palette (Ctrl+Shift+p) and select MCP: Add Server...

add MCP server

  1. Choose the option command (stdio) since the server will be run locally
  2. Type the command to run the MCP server:
uv --directory <path/to>/hpc-mcp run src/debug.py
  1. Select reasonable name for the server e.g. "HpcMcp" (camel case is a convention)
  2. Select whether to add the server locally or globally.
  3. You can tune the settings by opening setting.json (global settings) or .vscode/setting.json (workspace settings)

add MCP server

Zed
  1. Open Zed and go to settings.
  2. Open general settings CTRL-ALT-C
  3. Under section Model Context Protocol (MCP) Servers click Add Custom Server
  4. Add the following text (changing the <path/to>/hpc-mcp to your actual path)
{ /// The name of your MCP server "hpc-mcp": { /// The command which runs the MCP server "command": "uv", /// The arguments to pass to the MCP server "args": [ "--directory", "<path/to>/hpc-mcp", "run", "src/debug.py" ], /// The environment variables to set "env": {} } }

Test the MCP Server

Test the MCP using our simple example

  • open terminal
  • cd example/simple
  • build the example using make
  • this should generate segfault.exe
  • then type the following prompt into your IDE LLM agent
"debug a crash in the program examples/simple/segfault.exe"
  • this should ask your permission to run debug_crash MCP tool
  • accept and you should get a response like the following cursor-demo

Running local LLMs with Ollama

To run the hpc-mcp MCP tool with a local Ollama model use the Zed text editor. It should automatically detect local running ollama models and make them available. As long as you have installed the hpc-mcp MCP server in zed (see instructions here) it should be available to your models. For more info on ollama integration with zed see zed's documentation.

Note

Not all models support calling of MCP tools. I managed to have success with qwen3:latest.

Core Dependencies

  • python
  • uv
  • fastmcp
Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

A server that provides Model Control Protocol (MCP) tools for High Performance Computing, designed to integrate with Large Language Models in IDEs like Cursor and VSCode for debugging and other HPC tasks.

  1. Quick Start Guide :rocket:
    1. Adding the MCP Server
    2. Test the MCP Server
  2. Running local LLMs with Ollama
    1. Core Dependencies

      Related MCP Servers

      • -
        security
        A
        license
        -
        quality
        MCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
        Last updated -
        0
        4
        TypeScript
        MIT License
      • A
        security
        A
        license
        A
        quality
        A Model Context Protocol (MCP) server for Cursor IDE that simplifies the installation and configuration of other MCP servers.
        Last updated -
        3
        231
        63
        JavaScript
        MIT License
        • Apple
        • Linux
      • A
        security
        F
        license
        A
        quality
        A specialized server that helps users create new Model Context Protocol (MCP) servers by providing tools and templates for scaffolding projects with various capabilities.
        Last updated -
        8
        2
        TypeScript
      • A
        security
        F
        license
        A
        quality
        An all-in-one Model Context Protocol (MCP) server that connects your coding AI to numerous databases, data warehouses, data pipelines, and cloud services, streamlining development workflow through seamless integrations.
        Last updated -
        2
        Python
        • Apple
        • Linux

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/TomMelt/hpc-mcp'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server