matlab/matlab-mcp-core-server

GitHub: matlab/matlab-mcp-core-server

MathWorks官方推出的MCP服务器,让Claude、VS Code Copilot等AI应用能够直接调用本地MATLAB执行代码、分析代码质量和运行测试。

Stars: 216 | Forks: 28

# MATLAB MCP Core Server 使用 MathWorks® 官方的 MATLAB MCP Server,通过 AI 应用程序运行 MATLAB®。MATLAB MCP Core Server 允许您的 AI 应用程序: - 启动和退出 MATLAB。 - 编写并运行 MATLAB 代码。 - 评估 MATLAB 代码的风格和正确性。 ## 目录 - [设置](#setup) - [Claude Code](#claude-code) - [Claude Desktop](#claude-desktop) - [Visual Studio Code 中的 GitHub Copilot](#github-copilot-in-visual-studio-code) - [参数](#arguments) - [工具](#tools) - [资源](#resources) - [数据收集](#data-collection) ## 设置 1. 安装 [MATLAB (MathWorks)](https://www.mathworks.com/help/install/ug/install-products-with-internet-connection.html) 2020b 或更高版本,并将其添加到系统 PATH 中。 2. 对于 Windows 或 Linux,[**下载最新版本**](https://github.com/matlab/matlab-mcp-core-server/releases/latest)。(或者,您可以**从源代码构建**:安装 [Go](https://go.dev/doc/install) 并使用 `go install github.com/matlab/matlab-mcp-core-server/cmd/matlab-mcp-core-server@latest` 构建二进制文件)。 对于 macOS,首先在终端中运行以下命令下载最新版本: - 对于 Apple silicon 处理器,运行: curl -L -o ~/Downloads/matlab-mcp-core-server https://github.com/matlab/matlab-mcp-core-server/releases/latest/download/matlab-mcp-core-server-maca64 - 对于 Intel 处理器,运行: 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 Core Server: chmod +x ~/Downloads/matlab-mcp-core-server 3. 将 MATLAB MCP Core Server 添加到您的 AI 应用程序中。您可以在 AI 应用程序的文档中找到添加 MCP server 的说明。例如,关于使用 Claude Code®、Claude Desktop® 和 Visual Studio® Code 中的 GitHub Copilot 的说明,请参见下文。请注意,您可以通过指定可选的 [参数](#arguments) 来自定义服务器。 ### Claude Code 在终端中运行以下命令,记得插入您在设置中获取的服务器二进制文件的完整路径: ``` claude mcp add --transport stdio matlab -- /fullpath/to/matlab-mcp-core-server-binary ``` 您可以通过指定可选的 [参数](#arguments) 来自定义服务器。注意 Claude Code 的选项与服务器参数之间的 `--` 分隔符: ``` claude mcp add --transport stdio matlab -- /fullpath/to/matlab-mcp-core-server-binary --initial-working-folder=/home/username/myproject ``` 有关在 Claude Code 中添加 MCP server 的详细信息,请参阅 [Add a local stdio server (Claude Code)](https://docs.claude.com/en/docs/claude-code/mcp#option-3%3A-add-a-local-stdio-server)。若要稍后移除服务器,请运行: ``` claude mcp remove matlab ``` ### Claude Desktop 您使用 MATLAB MCP Core Server 包在 Claude Desktop 中安装 MATLAB MCP Core Server。 1. 在 Claude Desktop 中安装 Filesystem 扩展,以允许 Claude 读取和写入您系统上的文件。在 Claude Desktop 中,点击 **Settings > Extensions> Browse extensions**。搜索由 Anthropic 开发的 Filesystem 扩展并点击 **Install**。指定您希望允许 MCP server 访问的文件夹,然后将 **Disable** 按钮切换为 **Enable** 以启用 Filesystem 扩展。 2. 从 [Latest Release](https://github.com/matlab/matlab-mcp-core-server/releases/latest) 页面下载 MATLAB MCP Core Server 包 `matlab-mcp-core-server.mcpb`。 3. 要将 MATLAB MCP Core Server 包作为桌面扩展安装,请双击下载的 `matlab-mcp-core-server.mcpb` 文件,然后在 Claude Desktop 中点击 **Install**。(或者,在 Claude 中导航至 **File menu > Settings > Extensions > Advanced Settings > Install Extension** 并选择 `matlab-mcp-core-server.mcpb` 文件。点击 **Install**)。

要自定义 MATLAB MCP Core Server 的行为和 [参数](#arguments),请点击 **Configure**,然后点击 **Close Preview**。您可以通过导航至 **Settings > Extensions > Configure** 返回此页面。 ### Visual Studio Code 中的 GitHub Copilot VS Code 提供了不同的方法来 [Add an MCP Server (VS Code)](https://code.visualstudio.com/docs/copilot/customization/mcp-servers?wt.md_id=AZ-MVP-5004796#_add-an-mcp-server)。MathWorks 建议您按照 **"Add an MCP server to a workspace `mcp.json` file"** 部分中的步骤操作。在您的 `mcp.json` 配置文件中,添加以下内容,记得插入您在设置中获取的服务器二进制文件的完整路径,以及任何 [参数](#arguments): ``` { "servers": { "matlab": { "type": "stdio", "command": "/fullpath/to/matlab-mcp-core-server-binary", "args": [] } } } ``` ## 参数 在配置 AI 应用程序时,通过在 `args` 数组中提供参数来自定义服务器的行为。 | Argument | Description | Example | | ------------- | ------------- | ------------- | | matlab-root | 指定要启动哪个 MATLAB 的完整路径。不要在路径中包含 `/bin`。默认情况下,服务器会尝试在系统 PATH 中找到第一个 MATLAB。 | `"--matlab-root=/home/usr/MATLAB/R2025a"` | | initialize-matlab-on-startup | 要在启动服务器时立即初始化 MATLAB,请将此参数设置为 `true`。默认情况下,MATLAB 仅在调用第一个工具时启动。 | `"--initialize-matlab-on-startup=true"` | | initial-working-folder | 指定 MATLAB 启动的文件夹。如果您不提供此参数,MATLAB 将在以下位置启动:
  • Linux: `/home/username`
  • Windows: `C:\Users\username\Documents`
  • Mac: `/Users/username/Documents`
| `"--initial-working-folder=C:\\Users\\name\\MyProject"` | | matlab-display-mode | 指定是否显示 MATLAB 桌面。使用 `desktop` 模式(默认)显示 MATLAB 桌面。使用 `nodesktop` 模式仅从您的 AI 应用程序使用 MATLAB,而不显示 MATLAB 桌面。请注意,在 `nodesktop` 模式下,需要图形界面的命令(如 `edit`、`open`、`open_system`、`uifigure` 和 `appdesigner`)仍将在您的桌面上打开 MATLAB 窗口。| `"--matlab-display-mode=nodesktop"` | | disable-telemetry | 要禁用匿名数据收集,请将此参数设置为 `true`。有关详细信息,请参阅 [数据收集](#data-collection)。 | `"--disable-telemetry=true"` | ## 工具 1. `detect_matlab_toolboxes` - 返回有关已安装的 MATLAB 和 toolbox 的信息,包括版本号。 2. `check_matlab_code` - 对 MATLAB 脚本执行静态代码分析。返回有关编码风格、潜在错误、已弃用函数、性能问题和最佳实践违规的警告。这是一个非破坏性的只读操作,有助于在不执行脚本的情况下识别代码质量问题。 - 输入: - `script_path` (字符串):要分析的 MATLAB 脚本文件的绝对路径。必须是有效的 `.m` 文件。文件在分析期间不会被修改。示例:`C:\Users\username\matlab\myFunction.m` 或 `/home/user/scripts/analysis.m`。 3. `evaluate_matlab_code` - 评估一串 MATLAB 代码并返回输出。 - 输入: - `code` (字符串):要评估的 MATLAB 代码。 - `project_path` (字符串):项目目录的绝对路径。MATLAB 将此目录设置为当前工作文件夹。示例:`C:\Users\username\matlab-project` 或 `/home/user/research`。 4. `run_matlab_file` - 执行 MATLAB 脚本并返回输出。该脚本必须是有效的 `.m file`。 - 输入: - `script_path` (字符串):要执行的 MATLAB 脚本文件的绝对路径。必须是有效的 `.m` 文件。示例:`C:\Users\username\projects\analysis.m` 或 `/home/user/matlab/simulation.m`。 5. `run_matlab_test_file` - 执行 MATLAB 测试脚本并返回全面的测试结果。专为遵循 MATLAB 测试框架约定的 MATLAB 单元测试文件而设计。 - 输入: - `script_path` (字符串):MATLAB 测试脚本文件的绝对路径。必须是包含 MATLAB 单元测试的有效 `.m` 文件。示例:`C:\Users\username\tests\testMyFunction.m` 或 `/home/user/matlab/tests/test_analysis.m`。 ## 资源 MCP server 提供 [Resources (MCP)](https://modelcontextprotocol.io/specification/2025-03-26/server/resources) 以帮助您的 AI 应用程序编写 MATLAB 代码。要查看使用此资源的说明,请参阅您的 AI 应用程序中关于如何使用资源的文档。 1. `matlab_coding_guidelines` - 提供全面的 MATLAB 编码标准,以提高代码可读性、可维护性和协作性。这些指南涵盖命名约定、格式化、注释、性能优化和错误处理。 - URI:`guidelines://coding` - MIME 类型:`text/markdown` - 来源:[MATLAB Coding Standards (GitHub)](https://github.com/matlab/rules/blob/main/matlab-coding-standards.md) 2. `plain_text_live_code_guidelines` - 提供使用纯文本 Live Code `.m` 文件格式生成实时脚本的规则和指南,适用于版本控制和 AI 辅助开发。请注意,要运行纯文本实时脚本,您需要 MATLAB R2025a 或更新版本。有关详细信息,请参阅 [Live Code File Format (MathWorks)](https://www.mathworks.com/help/matlab/matlab_prog/plain-text-file-format-for-live-scripts.html)。 - URI:`guidelines://plain-text-live-code` - MIME 类型:`text/markdown` - 来源:[Plain Text Live Code Generation (GitHub)](https://github.com/matlab/rules/blob/main/live-script-generation.md) ## 数据收集 MATLAB MCP Core Server 可能会收集有关您服务器使用情况的完全匿名信息,并将其发送给 MathWorks。此数据收集有助于 MathWorks 改进产品,默认情况下处于开启状态。要选择退出数据收集,请将参数 `--disable-telemetry` 设置为 `true`。 # 使用 MATLAB MCP Core Server 时,您应该在运行所有工具调用之前对其进行彻底检查和验证。对于重要操作,始终让人参与其中,只有在您确信调用将完全按照您的预期执行时才继续。有关更多信息,请参阅 [User Interaction Model (MCP)](https://modelcontextprotocol.io/specification/2025-06-18/server/tools#user-interaction-model) 和 [Security Considerations (MCP)](https://modelcontextprotocol.io/specification/2025-06-18/server/tools#security-considerations)。 MATLAB MCP Core server 仅可用于作为个人自动化服务器 的 MATLAB 安装。不允许与中央自动化服务器一起使用。如果需要使用 Automation Server,请联系 MathWorks。有关更多信息,请参阅 [Program Offering Guide (MathWorks)](https://www.mathworks.com/help//pdf_doc/offering/offering.pdf)。 版权所有 2025-2026 The MathWorks, Inc.
标签:AI应用, Claude, CVE检测, EVTX分析, GitHub Copilot, Go语言, MathWorks, MATLAB, MCP Server, Subfinder, Visual Studio Code, 代码助手, 代码审查, 代码示例, 代码运行, 数据分析, 日志审计, 模型上下文协议, 科学计算, 程序破解, 编程工具, 脚本执行, 自动化执行, 远程代码执行, 集成开发环境