使用说明

项目简介

MATLAB MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在将强大的 MATLAB 功能与 AI 助手连接起来。通过该服务器，AI 助手可以执行 MATLAB 代码、根据自然语言描述生成 MATLAB 脚本，并直接访问 MATLAB 官方文档。这为 AI 应用在科学计算、数据分析、工程仿真等领域开辟了新的可能性。

主要功能点

MATLAB 代码执行：允许 AI 助手直接运行 MATLAB 代码，并返回执行结果，支持复杂的数值计算和算法应用。
MATLAB 脚本生成：AI 助手可以根据用户的自然语言描述，生成可执行的 MATLAB 代码，降低 MATLAB 使用门槛。
MATLAB 文档访问：通过资源 URI 'matlab://documentation/getting-started'，AI 助手可以访问 MATLAB 入门文档，方便用户快速上手。

安装步骤

安装 Node.js 和 npm：确保你的系统已安装 Node.js (v14 或更高版本) 和 npm。

全局安装 MATLAB MCP Server：打开终端或命令提示符，运行以下命令进行全局安装：

npm install -g matlab-mcp-server

或者，你也可以选择克隆仓库并手动构建：

git clone https://github.com/WilliamCloudQi/matlab-mcp-server.git
cd matlab-mcp-server
npm install
npm run build

服务器配置

要将 MATLAB MCP Server 与 MCP 客户端（如 Claude）配合使用，你需要配置客户端的 MCP 服务器设置。以 Claude 为例，你需要编辑配置文件 'claude_desktop_config.json'。

配置文件路径：
- macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'
添加服务器配置：在 'mcpServers' 字段下添加 'matlab-server' 的配置信息。请根据你的 MATLAB 安装路径修改 'MATLAB_PATH' 环境变量。

{
  "mcpServers": {
    "matlab-server": {
      "command": "node",
      "args": ["/path/to/matlab-server/build/index.js"],
      "env": {
        "MATLAB_PATH": "/path/to/matlab/executable"  // 将 "/path/to/matlab/executable" 替换为你的 MATLAB 可执行文件路径
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

'MATLAB_PATH' 环境变量说明：

你需要将 '/path/to/matlab/executable' 替换为你实际的 MATLAB 可执行文件路径。
- Windows 示例: 'C:\Program Files\MATLAB\R2023b\bin\matlab.exe'
- macOS 示例: '/Applications/MATLAB_R2023b.app/bin/matlab'
- Linux 示例: '/usr/local/MATLAB/R2023b/bin/matlab'

基本使用方法

配置完成后，启动 MCP 客户端（如 Claude）。客户端将自动连接到 MATLAB MCP Server。你可以通过自然语言指令或工具调用，指示 AI 助手使用以下工具：

execute_matlab_code: 执行 MATLAB 代码，例如：

{
  "tool_calls": [
    {
      "id": "tool_call_id",
      "type": "function",
      "function": {
        "name": "execute_matlab_code",
        "arguments": {
          "code": "disp('Hello from MATLAB!'); x = 1:10; plot(x, sin(x));",
          "saveScript": false
        }
      }
    }
  ]
}

generate_matlab_code: 根据自然语言描述生成 MATLAB 代码，例如：

{
  "tool_calls": [
    {
      "id": "tool_call_id_2",
      "type": "function",
      "function": {
        "name": "generate_matlab_code",
        "arguments": {
          "description": "Generate MATLAB code to calculate the Fibonacci sequence and plot the first 10 terms."
        }
      }
    }
  ]
}

访问 MATLAB 文档: 通过资源 URI 'matlab://documentation/getting-started' 获取入门指南。

AI 助手将根据你的指令调用相应的工具或访问资源，并返回 MATLAB 的执行结果、生成的代码或文档内容。

注意: 首次使用 'execute_matlab_code' 工具时，服务器会检查 MATLAB 是否可用。如果 MATLAB 不可用，将会返回错误提示，请确保 MATLAB 已正确安装并配置 'MATLAB_PATH' 环境变量。

关键词