hpc-mcp :zap::computer:

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 :rocket:

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:

Adding the MCP Server

Cursor

1. Open Cursor and go to settings.

2. Click Tools & Integrations

3. Click Add Custom MCP

4. Add the following configuration:

VSCode

1. Open command palette (Ctrl+Shift+p) and select MCP: Add Server...

2. Choose the option command (stdio) since the server will be run locally

3. Type the command to run the MCP server:

4. Select reasonable name for the server e.g. "HpcMcp" (camel case is a convention)

5. Select whether to add the server locally or globally.

6. You can tune the settings by opening setting.json (global settings) or .vscode/setting.json (workspace settings)

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)

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

• this should ask your permission to run debug_crash MCP tool

• accept and you should get a response like the following

Related MCP server: Cursor MCP Installer

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.

Core Dependencies

• python

• uv

• fastmcp