This topic explains how to verify component versions and resolve version-related issues after installation.

Verify docker image versions

Run the following command to list all OpenEdge MCP images with their versions:
docker images --format "table {{.Repository}}:{{.Tag}}\t{{.ID}}
\t{{.Size}}\t{{.CreatedAt}}" | grep openedge-mcp
The following output appears:
# openedge-mcp-server:1.0.0    <image-id>  <size>  <date>
# openedge-mcp-server:latest   <image-id>  <size>  <date>
# openedge-mcp-utils:1.0.0     <image-id>  <size>  <date>
# openedge-mcp-utils:latest    <image-id>  <size>  <date>

Verify components versions

Use these commands to check versions of different components:
  • To check distribution version, run:
    cat VERSION
  • To check version of the mcpgen utility, run:
    ./mcpgen --version
  • To check version of the running server while the container is active, run:
    docker run --rm openedge-mcp-server:latest python -c "
import sys, os
sys.path.insert(0, '/app/src')
try:
    with open('/app/VERSION', 'r') as f:
        print(f'Server Version: {f.read().strip()}')
except FileNotFoundError:
    print('Version file not found in container')
"

Profile and configuration version tracking

Use these commands to track profile creation details and verify configuration versions:
Action Command
List profiles 
./mcpgen list --wide
Check configuration version 
cat generated/<profile-name>/mcp_server_config.json | 
grep -A5 -B5 version ||echo "No version field in config"

Troubleshoot version mismatches

If you encounter version-related issues, follow these steps:
  1. If you encounter mixed versions across components, ensure all components use the same release:
    # Clean up old images
docker images | grep openedge-mcp | grep -v "v0.0.2\|latest" | 
awk '{print $3}' | xargs -r docker rmi
  2. If version tags are missing from your images, re-run the image loading process:
    ./load_images.sh
  3. If there are conflicts with the mcpgen utility, check if the correct wheel is installed:
    pip show mcpgen 2>/dev/null || echo "mcpgen not installed via pip"
Note: The VERSION file in your distribution is the single source of truth. All Docker images, mcpgen utility, and documentation should align with this version.