使用说明
MATLAB MCP核心服务器
使用AI应用程序运行MATLAB®。MATLAB MCP核心服务器允许您的AI应用程序:
- 启动并退出MATLAB。
- 编写并运行MATLAB代码。
- 评估MATLAB代码的风格和正确性。
目录
设置
-
安装 MATLAB(MathWorks) 2020b或更高版本,并将其添加到系统PATH中。
-
对于Windows或Linux,请下载 最新发布 来自GitHub®。或者,您可以安装 去 并使用从源代码构建二进制文件
go install github.com/matlab/matlab-mcp-core-server/cmd/matlab-mcp-core-server对于macOS,首先在终端中运行以下命令下载最新版本:
- 对于苹果硅处理器,请运行:
curl -L -o ~/Downloads/matlab-mcp-core-server https://github.com/matlab/matlab-mcp-core-server/releases/latest/download/matlab-mcp-core-server-maca64 - 对于英特尔处理器,运行:
curl -L -o ~/Downloads/matlab-mcp-core-server https://github.com/matlab/matlab-mcp-core-server/releases/latest/download/matlab-mcp-core-server-maci64
然后为下载的二进制文件授予可执行权限,以便您可以运行MATLAB MCP核心服务器:
chmod +x ~/Downloads/matlab-mcp-core-server - 对于苹果硅处理器,请运行:
-
将MATLAB MCP核心服务器添加到您的AI应用程序中。您可以在AI应用程序的文档中找到添加MCP服务器的说明。例如,在Visual Studio®代码中使用Claude Code®、Claude Desktop®和GitHub Copilot的说明,请参阅下文。请注意,您可以通过指定可选项来自定义服务器 参数.
克劳德代码
在您的终端中,运行以下命令,记住插入您在设置中获取的服务器二进制文件的完整路径:
claude mcp add --transport stdio matlab /fullpath/to/matlab-mcp-core-server-binary [arguments...]
您可以通过指定可选项来自定义服务器 参数:
claude mcp add --transport stdio matlab /fullpath/to/matlab-mcp-core-server-binary --initial-working-folder=/home/username/myproject
有关在Claude Code中添加MCP服务器的详细信息,请参阅 添加本地stdio服务器(克劳德代码)。要稍后删除服务器,请运行:
claude mcp remove matlab
克劳德桌面
按照页面上的说明进行操作 连接到本地MCP服务器(MCP) 安装Node.js和文件系统服务器。在Claude Desktop配置文件中,您需要添加MATLAB MCP核心服务器以及文件系统服务器的配置。您可以使用下面的组合JSON。在文件系统中 args,请记住指定服务器可以访问的路径。在MATLAB中 args,记得插入您获取的服务器二进制文件的完整路径,以及任何其他路径 参数(请注意,在Windows上,您的路径需要额外的反斜杠作为转义符)。
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"C:\\Users\\username"
]
},
"matlab": {
"command": "C:\\fullpath\\to\\matlab-mcp-core-server-binary",
"args": [
"--initial-working-folder=C:\\Users\\username\\Documents"
]
}
}
}
保存配置文件后,单击退出Claude Desktop 文件>退出,然后重新启动Claude Desktop。
Visual Studio代码中的GitHub副本
VS Code提供了不同的方法 添加MCP服务器(VS代码).MathWorks建议您按照本节中的步骤进行操作 “将MCP服务器添加到工作区 mcp.json 文件“.在你的 mcp.json 配置文件,添加以下内容,记住插入您在设置中获取的服务器二进制文件的完整路径,以及任何 参数:
{
"servers": {
"matlab": {
"type": "stdio",
"command": "/fullpath/to/matlab-mcp-core-server-binary",
"args": []
}
}
}
参数
通过在中提供参数来自定义服务器的行为 args 配置AI应用程序时使用数组。
| 参数 | 描述 | 示例 |
|---|---|---|
| matlab根 | 指定要启动哪个matlab的完整路径。不要包括 /bin 在路上。默认情况下,服务器会尝试在系统PATH中找到第一个MATLAB。 |
"--matlab-root=/home/usr/MATLAB/R2025a" |
| 初始工作文件夹 | 指定MATLAB启动和服务器生成任何MATLAB脚本的文件夹。如果不提供参数,MATLAB将从以下位置开始:
|
"--initial-working-folder=C:\\Users\\name\\MyProject" |
| disable telemetry | 要禁用匿名数据收集,请将此参数设置为 true。有关详细信息,请参阅 数据收集. |
"--disable-telemetry=true" |
工具
-
detect_matlab_toolboxes- 列出已安装的MATLAB工具箱及其版本信息。
-
check_matlab_code- 在MATLAB脚本上执行静态代码分析。返回有关编码风格、潜在错误、弃用函数、性能问题和违反最佳实践的警告。这是一种非破坏性的只读操作,有助于在不执行脚本的情况下识别代码质量问题。
- 输入:
script_path(string):要分析的MATLAB脚本文件的绝对路径。必须是a.m文件位于允许的目录中。分析过程中不会修改文件。例子:C:\Users\username\matlab\myFunction.m或/home/user/scripts/analysis.m.
-
evaluate_matlab_code- 计算MATLAB代码字符串并返回输出。
- 输入:
code(string):MATLAB代码进行求值。project_path(string):允许的项目目录的绝对路径。MATLAB将此目录设置为当前工作文件夹。例子:C:\Users\username\matlab-project或/home/user/research.
-
run_matlab_file- 执行MATLAB脚本并返回输出。脚本必须是有效的
.m file. - 输入:
script_path(string):要执行的MATLAB脚本文件的绝对路径。必须是有效的.m文件位于允许的目录中。例子:C:\Users\username\projects\analysis.m或/home/user/matlab/simulation.m.
- 执行MATLAB脚本并返回输出。脚本必须是有效的
-
run_matlab_test_file- 执行MATLAB测试脚本并返回全面的测试结果。专为遵循MATLAB测试框架约定的MATLAB单元测试文件而设计。
- 输入:
script_path(string):MATLAB测试脚本文件的绝对路径。必须是有效的.m包含MATLAB单元测试的文件,位于允许的目录中。例子:C:\Users\username\tests\testMyFunction.m或/home/user/matlab/tests/test_analysis.m.
数据收集
MATLAB MCP核心服务器可能会收集有关您使用服务器的完全匿名信息,并将其发送给MathWorks。此数据收集有助于MathWorks改进产品,默认情况下处于打开状态。要选择退出数据收集,请设置参数 --disable-telemetry 到 true.
免责声明
MATLAB MCP核心服务器按“原样”提供,不提供任何明示或暗示的保证。使用此服务器即表示您承认并接受,您对所采取的任何行动以及使用此服务器所产生的任何后果负全部责任。您有责任在执行之前彻底审查和验证所有工具调用。此服务器的开发人员和提供商对因使用而导致的损失、损坏或伤害不承担任何责任。
版权所有2025 The MathWorks,股份有限公司。