Make a installer with correct MCP settings.

Author: neuromechanist

.gitignore

@@ -46,6 +46,7 @@ octave-workspace
 matlab_output/
 test_output/
 *.code-workspace
+mcp-pip.json
 
 # Jupyter
 .ipynb_checkpoints/

README.md

@@ -6,6 +6,7 @@ A Model Context Protocol (MCP) server that provides tools for developing and run
 
 - Python 3.8+
 - MATLAB with Python Engine installed
+- uv package manager (recommended)
 
 ## Features
 
@@ -22,6 +23,50 @@ A Model Context Protocol (MCP) server that provides tools for developing and run
 
 ## Installation
 
+### Using pip (Recommended)
+
+1. Clone this repository:
+```bash
+git clone [repository-url]
+cd matlab-mcp-tools
+```
+
+2. Set the MATLAB path environment variable if your MATLAB is not in the default location:
+```bash
+# For macOS (default is /Applications/MATLAB_R2024b.app)
+export MATLAB_PATH=/path/to/your/matlab/installation
+
+# For Windows (default might be C:\Program Files\MATLAB\R2024b)
+# set MATLAB_PATH=C:\path\to\your\matlab\installation
+```
+
+3. Run the setup script to install the package with pip:
+```bash
+./setup-pip-matlab-mcp.sh
+```
+
+4. Configure Cline/Cursor by copying the provided MCP configuration:
+```bash
+# For macOS/Linux
+cp mcp-pip.json ~/.cursor/mcp.json
+
+# For Windows
+# copy mcp-pip.json %USERPROFILE%\.cursor\mcp.json
+```
+
+5. Test the installation:
+```bash
+./test-pip-matlab-mcp.sh
+```
+
+After setup, you can run the MATLAB MCP server using:
+```bash
+matlab-mcp-server
+```
+
+
+### Using Conda (Alternative)
+
 1. Clone this repository:
 
 ```bash
@@ -40,18 +85,61 @@ conda activate matlab-mcp
 pip install -e .
 ```
 
-4. Install MATLAB Engine for Python:
+4. Set the MATLAB path environment variable:
+```bash
+# For macOS (default is /Applications/MATLAB_R2024b.app)
+export MATLAB_PATH=/path/to/your/matlab/installation
+
+# For Windows (default might be C:\Program Files\MATLAB\R2024b)
+# set MATLAB_PATH=C:\path\to\your\matlab\installation
+```
+
+5. Install MATLAB Engine for Python:
 ```bash
 # Navigate to MATLAB engine directory
-cd /Applications/MATLAB_R2024b.app/extern/engines/python
+cd $MATLAB_PATH/extern/engines/python
 
 # Install MATLAB engine
 python setup.py install
 ```
 
-5. Add MATLAB to system PATH:
+6. Add MATLAB to system PATH:
 ```bash
-export PATH="/Applications/MATLAB_R2024b.app/:$PATH"
+# For macOS/Linux
+export PATH="$MATLAB_PATH/bin:$PATH"
+
+# For Windows
+# set PATH=%MATLAB_PATH%\bin;%PATH%
+```
+
+7. Create a configuration file for Cline/Cursor:
+```bash
+cat > mcp-conda.json << EOF
+{
+  "mcpServers": {
+    "matlab": {
+      "command": "matlab-mcp-server",
+      "args": [],
+      "env": {
+        "MATLAB_PATH": "\${MATLAB_PATH}",
+        "PATH": "\${MATLAB_PATH}/bin:\${PATH}"
+      },
+      "disabled": false,
+      "autoApprove": [
+        "list_tools",
+        "get_script_sections"
+      ]
+    }
+  }
+}
+EOF
+
+# Copy to Cline/Cursor configuration
+# For macOS/Linux
+cp mcp-conda.json ~/.cursor/mcp.json
+
+# For Windows
+# copy mcp-conda.json %USERPROFILE%\.cursor\mcp.json
 ```
 
 ## Usage

pyproject.toml

@@ -15,7 +15,7 @@ readme = "README.md"
 license = { file = "LICENSE" }
 
 [project.scripts]
-matlab-mcp = "matlab_mcp.server:main"
+matlab-mcp-server = "matlab_mcp.server:main"
 
 [build-system]
 requires = ["setuptools>=61.0"]

setup-pip-matlab-mcp.sh

@@ -0,0 +1,67 @@
+#!/bin/bash
+set -euo pipefail
+
+# Define variables
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+MATLAB_PATH=${MATLAB_PATH}
+
+# Print header
+echo "Setting up matlab-mcp-server with pip"
+echo "MATLAB path: $MATLAB_PATH"
+echo "Project dir: $SCRIPT_DIR"
+
+# Check if MATLAB exists
+if [ ! -d "$MATLAB_PATH" ]; then
+    echo "Error: MATLAB not found at $MATLAB_PATH"
+    echo "Please set the MATLAB_PATH environment variable to the correct location"
+    exit 1
+fi
+
+# Install matlabengine first from MATLAB installation
+echo -e "\nInstalling MATLAB engine"
+cd "$MATLAB_PATH/extern/engines/python"
+python -m pip install .
+cd "$SCRIPT_DIR"
+
+# Build and install the package with pip
+echo -e "\nBuilding and installing matlab-mcp-server with pip"
+pip install -e .
+
+# Test if the installation was successful
+echo -e "\nTesting installation"
+if command -v matlab-mcp-server &> /dev/null; then
+    echo "Installation successful! matlab-mcp-server is available in PATH"
+else
+    echo "Warning: matlab-mcp-server not found in PATH"
+    echo "Please check the logs for more information"
+    exit 1
+fi
+
+# Update the MCP configuration
+echo -e "\nUpdating MCP configuration"
+cat > mcp-pip.json << EOF
+{
+  "mcpServers": {
+    "matlab": {
+      "command": "matlab-mcp-server",
+      "args": [],
+      "env": {
+        "MATLAB_PATH": "${MATLAB_PATH}",
+        "PATH": "${MATLAB_PATH}/bin:${PATH}"
+      },
+      "disabled": false,
+      "autoApprove": [
+        "list_tools",
+        "get_script_sections"
+      ]
+    }
+  }
+}
+EOF
+
+echo -e "\nSetup complete!"
+echo "To use the MATLAB MCP server with Cursor/Cline, copy the provided configuration:"
+echo "cp mcp-pip.json ~/.cursor/mcp.json"
+echo ""
+echo "To manually start the server, run:"
+echo "matlab-mcp-server"

test-pip-matlab-mcp.sh

@@ -0,0 +1,64 @@
+#!/bin/bash
+set -euo pipefail
+
+# Test if matlab-mcp-server is available
+echo -e "\n=== Testing Installation ==="
+if command -v matlab-mcp-server &> /dev/null; then
+    echo "matlab-mcp-server is available in PATH"
+else
+    echo "Error: matlab-mcp-server not found in PATH"
+    echo "Please run ./setup-pip-matlab-mcp.sh first"
+    exit 1
+fi
+
+# Create a test MATLAB script
+echo -e "\n=== Setting up Test Files ==="
+echo "Creating a simple test script..."
+
+# Create a test MATLAB script if it doesn't exist
+EXAMPLE_DIR="examples/matlab_scripts"
+mkdir -p "$EXAMPLE_DIR"
+
+TEST_SCRIPT="$EXAMPLE_DIR/test_plot.m"
+if [ ! -f "$TEST_SCRIPT" ]; then
+  cat > "$TEST_SCRIPT" << 'EOF'
+% Simple test script for MATLAB MCP
+x = linspace(0, 2*pi, 100);
+y = sin(x);
+
+% Create a figure with some styling
+figure;
+plot(x, y, 'LineWidth', 2);
+title('Sine Wave');
+xlabel('x');
+ylabel('sin(x)');
+grid on;
+
+% Add some annotations
+text(pi, 0, '\leftarrow \pi', 'FontSize', 12);
+
+disp('Script executed successfully!')
+EOF
+fi
+
+# Test if matlabengine is installed
+echo -e "\n=== Testing MATLAB Engine Installation ==="
+MATLAB_PATH=${MATLAB_PATH:-"/Applications/MATLAB_R2024b.app"}
+export PATH="$MATLAB_PATH/bin:$PATH"
+python -c "import matlab.engine; print('MATLAB engine is properly installed')" || echo "Warning: MATLAB engine not properly installed"
+
+# Test starting the server
+echo -e "\n=== Testing Server Startup ==="
+echo "Starting the server in the background (will terminate after 5 seconds)..."
+matlab-mcp-server &
+SERVER_PID=$!
+sleep 5
+kill $SERVER_PID 2>/dev/null || true
+
+echo -e "\n=== Test Complete ==="
+echo "The installation has been tested successfully."
+echo "To use the MATLAB MCP server with Cursor/Cline, copy the provided configuration:"
+echo "cp mcp-pip.json ~/.cursor/mcp.json"
+echo ""
+echo "To manually start the server, run:"
+echo "matlab-mcp-server"