## 背景

MathWorks 官方发布了 MATLAB MCP Core Server，通过 MCP 协议让 AI 编码助手直接调用 MATLAB。官方列出的支持客户端有 Claude Code、VS Code Copilot、Gemini CLI 等。我在腾讯云代码助手（CodeBuddy）上试了一下，工具加载不出来。同配置文件里的其它两个 MCP server 都正常，唯独 MATLAB 这个不行。折腾了一阵，发现是 MCP 协议层面的问题。下面把排查过程和解决方案记录一下。

## 排查过程

先确认最基本的事情：MATLAB 本身能跑，`matlab -batch "disp('OK')"` 正常输出；server 进程确实启动了，任务管理器能看到；JSON 配置格式没问题，其他 server 正常。说明 CodeBuddy 启动了 server，但连接没建立起来。

接下来是最花时间的一步——确认传输格式。MCP 的 stdio 传输有两种常见格式：一种是 JSON Lines（每条消息一行 JSON），另一种是 Content-Length（类似 LSP 协议，带 HTTP Header 风格的长度前缀）。我一开始假设 CodeBuddy 用 Content-Length，MATLAB server 用 JSON Lines，于是写了个 Python wrapper 做格式转换。这个假设是错的，浪费了不少时间。

怎么发现的呢？直接去读了能正常工作的 unsplash MCP server 的源码。它用的是 `@modelcontextprotocol/sdk` 的 `StdioServerTransport`，发送逻辑就是 `stdout.write(json)`——直接写 JSON 字符串，没有任何 Content-Length header。在整个 SDK 里搜索 `Content-Length`，结果为零。这说明 CodeBuddy 作为客户端用的就是 JSON Lines，跟 MATLAB server 一样。**两边格式一致，根本不需要格式转换。**

既然格式没问题，那问题出在消息交互层面。我在 server 前面加了一层轻量 Python wrapper，把每一条双向消息都记到日志里。这一步是排查中最有用的——看到消息流就全明白了：

```
CB→Server: {"method":"initialize",...}              ← 客户端发起握手
Server→CB: {"id":0,"result":{...}}                  ← 服务端回复
CB→Server: {"method":"notifications/initialized"}   ← 客户端确认
Server→CB: {"id":1,"method":"roots/list"}           ← 服务端主动请求！
CB→Server: {"method":"tools/list","id":1}            ← 客户端请求工具列表
...之后再无 response，两边都在等对方...
```

握手完成后，MATLAB server 主动发了一个 `roots/list` 请求，问客户端"你有几个工作区目录？"。这是 MCP 协议里 server→client 方向的请求，完全合规。但 CodeBuddy 不处理这类请求，没有回复。Server 就一直在等这个回复，同时 CodeBuddy 发来的 `tools/list` 请求排在后面没人处理。两边互相等，死锁了。

## 解决方案

原因清楚了，修复也简单——wrapper 层自动回复 server 发起的这类请求就行：

```python
def auto_reply_server_request(msg):
    method = msg.get("method", "")
    req_id = msg.get("id")
    if method == "roots/list":
        resp = {"jsonrpc": "2.0", "id": req_id, "result": {"roots": []}}
        send_to_server(json.dumps(resp).encode())
        return True
    if method == "sampling/createMessage":
        resp = {"jsonrpc": "2.0", "id": req_id,
                "error": {"code": -32601, "message": "Not supported"}}
        send_to_server(json.dumps(resp).encode())
        return True
    return False
```

修复后的日志：

```
Server→CB: {"id":1,"method":"roots/list"}
Auto-replied to roots/list id=1                      ← wrapper 回复空列表
CB→Server: {"method":"tools/list","id":1}
Server→CB: {"id":1,"result":{"tools":[...]}}          ← 5 个工具全部返回
```

MATLAB MCP 的全部 5 个工具（`evaluate_matlab_code`、`detect_matlab_toolboxes`、`check_matlab_code`、`run_matlab_file`、`run_matlab_test_file`）加载成功。跑一下验证：

```
> mcp_call_tool("matlab", "evaluate_matlab_code", {"code": "disp('Hello'); ver"})
Hello
MATLAB 版本: 25.1.0.2943329 (R2025a)
...
```

正常工作了。

## 原因分析

MCP 协议支持双向请求——客户端可以问 server 要工具列表，server 也可以问客户端要工作区信息。这是一个合理的设计。但当一个不支持 server→client 请求的客户端，遇到一个会发这类请求的 server，就会死锁。这个问题不是个例，MCP Python SDK 的 GitHub Issue [#1097](https://github.com/modelcontextprotocol/python-sdk/issues/1097) 报告了同样的 `roots/list` 阻塞问题，官方标记为 P1。

## 改进建议

这个问题原因是 MATLAB MCP Server 在客户端未声明 `roots` 能力时，仍然发送阻塞式请求。建议两个方向改进：

**对 CodeBuddy：** 收到未实现的 server→client 请求时，返回标准 JSON-RPC error response（`Method not found`，错误码 `-32601`），而不是静默忽略。这样 server 端不会阻塞。

**对 MathWorks：** Server 端的 `roots/list` 请求应设置超时（比如 5 秒），超时后跳过继续工作。这样能兼容所有客户端。

两个改动都不大，任一实现即可消除此类兼容性问题。

## 附录：完整 wrapper 脚本

```python
"""MCP shim: auto-replies to server→client requests (roots/list etc)
so that clients not implementing these requests can still work."""
import subprocess, sys, os, threading, json, time

EXE_DIR = os.path.dirname(os.path.abspath(__file__))
SERVER = os.path.join(EXE_DIR, "matlab-mcp-core-server-real.exe")
LOG = os.path.join(EXE_DIR, "wrapper.log")

def log(msg):
    try:
        with open(LOG, "a", encoding="utf-8") as f:
            f.write(f"[{time.strftime('%H:%M:%S')}] {msg}\n")
    except:
        pass

def write_cl_frame(stream, body):
    if isinstance(body, str):
        body = body.encode("utf-8")
    stream.write(f"Content-Length: {len(body)}\r\n\r\n".encode() + body)
    stream.flush()

def read_jsonline(stream):
    line = b""
    while True:
        b = stream.read(1)
        if not b:
            return line if line else None
        if b == b'\n':
            return line.rstrip(b'\r')
        line += b
        if len(line) > 1_000_000:
            return line

def read_any_message(stream):
    """Auto-detect Content-Length vs JSON Lines."""
    first = stream.read(1)
    if not first:
        return None, None
    if first == b'{':
        line = first
        while True:
            b = stream.read(1)
            if not b:
                return line, "jsonl"
            if b == b'\n':
                return line.rstrip(b'\r'), "jsonl"
            line += b
            if len(line) > 1_000_000:
                return line, "jsonl"
    elif first.upper() == b'C':
        header = first
        while not header.endswith(b"\r\n\r\n"):
            b = stream.read(1)
            if not b:
                return None, None
            header += b
        header = header.replace(b'\xef\xbb\xbf', b'')
        length = 0
        for line in header.decode("utf-8", errors="replace").split("\r\n"):
            if line.lower().startswith("content-length:"):
                try:
                    length = int(line.split(":", 1)[1].strip())
                except ValueError:
                    pass
                break
        if length == 0:
            return b"", "cl"
        body = b""
        while len(body) < length:
            chunk = stream.read(length - len(body))
            if not chunk:
                return None, None
            body += chunk
        body = body.replace(b'\xef\xbb\xbf', b'')
        return body, "cl"
    else:
        return None, None

def send_to_cb(body):
    if isinstance(body, bytes):
        body = body.decode("utf-8")
    if output_format[0] == "cl":
        write_cl_frame(sys.stdout.buffer, body)
    else:
        sys.stdout.buffer.write(body.encode("utf-8") + b"\n")
        sys.stdout.buffer.flush()

def send_to_server(body_bytes):
    if not body_bytes.endswith(b'\n'):
        body_bytes += b'\n'
    proc.stdin.write(body_bytes)
    proc.stdin.flush()

def auto_reply_server_request(msg):
    method = msg.get("method", "")
    req_id = msg.get("id")
    if method == "roots/list":
        resp = {"jsonrpc": "2.0", "id": req_id, "result": {"roots": []}}
        send_to_server(json.dumps(resp).encode())
        return True
    if method == "sampling/createMessage":
        resp = {"jsonrpc": "2.0", "id": req_id,
                "error": {"code": -32601, "message": "Not supported"}}
        send_to_server(json.dumps(resp).encode())
        return True
    return False

proc = None
output_format = [None]
initialized = threading.Event()

def main():
    global proc
    proc = subprocess.Popen(
        [SERVER] + sys.argv[1:],
        stdin=subprocess.PIPE, stdout=subprocess.PIPE,
        stderr=sys.stderr, bufsize=0,
    )

    def stdin_to_server():
        try:
            while True:
                body, fmt = read_any_message(sys.stdin.buffer)
                if body is None:
                    break
                if not body:
                    continue
                if output_format[0] is None:
                    output_format[0] = fmt
                send_to_server(body)
        except:
            pass
        finally:
            try: proc.stdin.close()
            except: pass

    def server_to_stdout():
        try:
            while True:
                line = read_jsonline(proc.stdout)
                if line is None:
                    break
                if not line.strip():
                    continue
                try:
                    msg = json.loads(line)
                except:
                    continue
                # Auto-reply to server-initiated requests
                if "method" in msg and "id" in msg and "result" not in msg and "error" not in msg:
                    if auto_reply_server_request(msg):
                        continue
                # Before init: only forward responses
                if not initialized.is_set():
                    if "id" in msg and ("result" in msg or "error" in msg):
                        send_to_cb(line)
                        initialized.set()
                else:
                    send_to_cb(line)
        except:
            pass

    t_in = threading.Thread(target=stdin_to_server, daemon=True)
    t_out = threading.Thread(target=server_to_stdout, daemon=True)
    t_out.start()
    t_in.start()
    proc.wait()
    sys.exit(proc.returncode)

if __name__ == "__main__":
    main()
```

使用方法：
1. 将脚本保存到 `~/.matlab/agentic-toolkits/bin/matlab-mcp-wrapper.py`
2. 确保 `matlab-mcp-core-server-real.exe`（从 [GitHub Releases](https://github.com/matlab/matlab-mcp-core-server/releases) 下载）在同目录下
3. 在 `~/.codebuddy/mcp.json` 中添加配置：

```json
{
  "matlab": {
    "command": "python",
    "args": ["C:\\Users\\xxx\\.matlab\\agentic-toolkits\\bin\\matlab-mcp-wrapper.py",
             "--matlab-root", "D:\\Program Files\\MATLAB\\R2025a",
             "--matlab-display-mode", "desktop"]
  }
}
```

4. Reload Window

---

@腾讯云 @CodeBuddy

本文方案已在 Windows 11 + MATLAB R2025a + CodeBuddy 下验证通过。

MathWorks 官方发布了 MATLAB MCP Core Server，通过 MCP 协议让 AI 编码助手直接调用 MATLAB。官方列出的支持客户端有 Claude Code、VS Code Copilot、Gemini CLI 等。我在腾讯云代码助手（CodeBuddy）上试了一下，工具加载不出来。同配置文件里的其它两个 MCP server 都正常，唯独 MATLAB 这个不行。折腾了一阵，发现是 MCP 协议层面的问题。下面把排查过程和解决方案记录一下。

腾讯云 CodeBuddy 接入 MATLAB MCP 完整方案（含兼容性问题修复）

MathWorks MATLAB MCP Server 在腾讯云 CodeBuddy 中无法加载工具，原因是 roots/list 死锁：Server 主动发请求，客户端不回复，双方永久阻塞。本文记录排查过程，附 150 行 wrapper 脚本及两端改进建议。

云计算

编程语言

开发工具

本文介绍MATLAB MCP Core Server与腾讯云CodeBuddy兼容性问题解决方案。通过分析MCP协议死锁原因，提供Python wrapper脚本自动回复server请求，成功实现MATLAB工具调用。包含完整排查步骤、修复代码及配置方法，适用于Windows+MATLAB R2025a环境。

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

腾讯云 CodeBuddy 接入 MATLAB MCP 完整方案（含兼容性问题修复）-腾讯云开发者社区-腾讯云

腾讯云 CodeBuddy 接入 MATLAB MCP 完整方案（含兼容性问题修复）

腾讯云 CodeBuddy 接入 MATLAB MCP 完整方案（含兼容性问题修复）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐