Model Context Protocol server¶
eb-stack mcp serves the version-one commands on stdin and stdout.
One JSON-RPC object occupies one line. --workspace sets the root for
the recipe file tools and exports EB_STACK_WORKSPACE for that process.
When the flag is omitted, an existing EB_STACK_WORKSPACE is kept.
Otherwise the server uses its current directory. eb-stack mcp --help
prints those flags and exits 0.
The registry manifest is server.json at the repository root. The file
uses the 2025-12-11 server schema
(server.schema.json).
The server name is io.github.stackhands/eb-stack. The package is the cargo
crate eb_stack at the version in Cargo.toml, from https://crates.io,
with transport stdio. One positional argument is mcp. --workspace
is an optional named argument. Cargo installs the binary named
eb-stack. The manifest has no runtime hint: cargo install runs once,
and the client then runs that binary by name.
Build the binary¶
Rust 1.90 or newer builds this tree. The binary that the snippets below
call is eb-stack.
cargo build --locked --release
install -Dm755 target/release/eb-stack ~/.local/bin/eb-stack
eb-stack mcp --help
Clients with an mcpServers file¶
A desktop client that reads a JSON file with a top-level mcpServers key
takes the entry below. Restart the client after saving the file. A client
that does not expand ${workspaceFolder} needs an absolute path in
--workspace.
{
"mcpServers": {
"eb-stack": {
"command": "eb-stack",
"args": ["mcp", "--workspace", "/absolute/path/to/the/clone"]
}
}
}
Visual Studio Code and Copilot¶
A portable file uses a top-level mcpServers object. The Visual Studio
Code file uses a top-level servers object. Copying one file onto the
other without changing that key drops the server.
The Visual Studio Code file is .vscode/mcp.json in the workspace, or
mcp.json in the user profile. ${workspaceFolder} expands in that
file. type is stdio.
{
"servers": {
"eb-stack": {
"type": "stdio",
"command": "eb-stack",
"args": ["mcp", "--workspace", "${workspaceFolder}"]
}
}
}
A workspace-root .mcp.json uses mcpServers. The Copilot user file
does too. That user file is $COPILOT_HOME/mcp-config.json, or
~/.copilot/mcp-config.json when COPILOT_HOME is unset. A portable
file does not expand Visual Studio Code input variables. Pass an
absolute path there.
{
"mcpServers": {
"eb-stack": {
"command": "eb-stack",
"args": ["mcp", "--workspace", "/absolute/path/to/the/clone"]
}
}
}
Tools¶
The catalog has 60 tools. tools/list returns one tool for each CLI
command in the table, and the recipe and easyblock tools that have no
command. mcp publishes that catalog and has no tool of its own. Each
command’s tool calls the same runner as that command. The text field
of a successful result is that command’s stdout. Each argument is a
name in the schema tools/list returns. The
CLI reference records the flags.
Command |
Tool |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
These tools edit files or run EasyBuild. They are not CLI commands.
Tool |
Role |
|---|---|
|
Read one UTF-8 file inside the workspace root |
|
List one directory inside the workspace root |
|
Replace an exact string in a workspace file |
|
Apply a review suggestion to the lines it is anchored on |
|
Show what changed in each recipe since the server first saw it |
|
Create or overwrite a UTF-8 file inside the workspace root |
|
Search workspace files for a literal, or a regular expression |
|
List easyconfig versions of one dependency in a local tree |
|
Check Python modules that ship with recipes |
|
Run |
|
Read an EasyBuild log by step |
|
Run a build |
eb_build_test runs only when EB_STACK_ALLOW_BUILD=1.