E2studio MCP

Renesas RX 的 E2 MCP

稳定版本：1.0.0

E2 MCP是一个MCP服务器和VS Code集成层，用于使用E2 Studio进行瑞萨RX开发。

它是为实用的工作流程而构建的：

• MCP客户端或AI助手可以构建、检查、闪存、调试和读取目标输出
• VS Code将所选项目、构建配置、启动文件和调试器保持在真实工作区中
• 可选的侧边栏允许用户手动控制完全相同的操作

结果是人为驱动和MCP驱动的固件工作都有一个单一的执行路径。

此存储库包含什么

此存储库分为两个协作部分：

• src/e2studio_mcp/：公开工具和资源的Python MCP服务器
• vscode-extension/：在编辑器中锚定瑞萨电子项目状态和硬件操作的VS Code扩展

如果只看扩展，就会错过MCP服务器。

如果你只看MCP服务器，你会错过使构建、闪存和调试可靠的编辑器端状态。

MCP第一工作流程

E2 MCP不是设计为稍后添加AI层的通用构建助手。

预期流程为：

1. 在VS Code中打开瑞萨电子工作区
2. 让扩展检测或加载工具链和可用项目
3. 选择活动项目、构建配置、启动文件和调试器一次
4. 使用MCP工具构建、检查内存、闪存固件、开始调试或读取ADM控制台
5. 只要你想直接手动控制，就回到侧边栏

这使得MCP客户端与用户在编辑器中看到的相同项目状态保持一致。

核心能力

• 通过以下方式构建e2 Studio项目 make 或 e2studioc
• 发现项目并解析 .cproject 元数据
• 读取链接器 .map 文件和计算ROM、RAM和DataFlash的使用情况
• 通过VS Code扩展启动或停止瑞萨调试会话
• 闪光 .mot 使用Renesas调试堆栈输出
• 从目标捕获ADM虚拟控制台输出
• 将上述所有内容作为MCP工具和资源公开

建筑

graph TD
    Client["VS Code / MCP Client / AI Assistant"]

    Client -- MCP --> Server["e2studio_mcp.server"]

    Server --> Build["build.py
make · e2studioc"]
    Server --> Project["project.py
.cproject parsing"]
    Server --> Mapfile["mapfile.py
linker map / memory"]
    Server --> Flash["flash.py
e2-server-gdb / flash"]
    Server --> ADM["adm.py
virtual console"]

    subgraph ext ["VS Code Extension"]
        State["Project / Config / Launch / Debugger state"]
        Sidebar["Sidebar UI — manual control"]
    end

    Server -- reads state --> ext
    Flash -- spawns --> GDB["e2-server-gdb + rx-elf-gdb"]
    Build -- invokes --> Make["make / e2studioc"]
    GDB --> HW["Renesas RX target"]
    Make --> Toolchain["CCRX toolchain"]

MCP工具

构建

• build_project(project?, config?, mode?)
• clean_project(project?, config?, mode?)
• rebuild_project(project?, config?, mode?)
• get_build_status(project?)

项目与记忆

• list_projects()
• get_project_config(project?, config?)
• get_build_size(project?, config?)
• get_map_summary(project?, config?)
• get_linker_sections(project?, config?)

Flash和调试

• debug_start(project?)
• debug_stop()
• debug_status()
• get_adm_log(port?, wait_seconds?, duration_ms?, poll_ms?, max_bytes?)

MCP资源

• e2studio://build/log
• e2studio://debug/adm/log
• e2studio://project/memory
• e2studio://project/config
• e2studio://activity/log

VS代码扩展

扩展在 vscode-extension/ 是MCP工作流的编辑器端控制平面。

它提供：

• 项目选择
• 构建配置选择
• 启动文件选择
• 调试器选择
• 手动构建、清理、重建、闪存、调试和停止操作
• 虚拟控制台输出访问
• MCP客户端可以安全重用的工作区感知状态

当前市场面临的扩展寿命README vscode-extension/README.md.

需求

• 视窗
• python >= 3.10
• 已安装瑞萨电子e2 Studio
• 瑞萨RX工具链可用： CCRX, make, e2-server-gdb, rx-elf-gdb
• 包含Renesas e2 Studio项目的工作区 .cproject 文件
• 对于VS Code调试集成： renesaselectronicscorporation.renesas-debug

仓库的规划

e2studio-mcp/
  src/e2studio_mcp/
    server.py
    build.py
    project.py
    mapfile.py
    flash.py
    adm.py
    config.py
  tests/
  scripts/
  vscode-extension/

安装Python服务器

cd e2Studio_2024_workspace/e2studio-mcp
py -3 -m pip install -e .

可选开发依赖关系：

py -3 -m pip install -e .[dev]

配置

不需要配置文件。所有设置均来自 VS代码设置 (e2mcp.*)以及 自动检测.

VS代码设置

MCP服务器环境变量

独立运行Python服务器（不带扩展）时，通过环境变量传递设置：

如果未设置，则会从标准瑞萨安装位置自动检测工具链路径。Flash/debug参数来自e2 Studio .launch 文件夹。已知的设备（RX651、RX65N、RX72N）是内置的。

运行MCP服务器

cd e2Studio_2024_workspace/e2studio-mcp
py -3 -m e2studio_mcp.server

或者：

py -3 -m e2studio_mcp

扩展构建

cd e2Studio_2024_workspace/e2studio-mcp/vscode-extension
npm install
npm run compile

测试

运行单元测试：

cd e2Studio_2024_workspace/e2studio-mcp
py -3 -m pytest -q

许可证

专有的。看 LICENSE.txt.

cd e2Studio_2024_workspace/e2studio-mcp
py -3 tests/smoke_test.py

故障排除

• make not found：set e2mcp.makePath 在VS代码设置中。
• sed, ccrx 哦 renesas_cc_converter 未找到 make：检查 e2mcp.e2studioPath y e2mcp.ccrxPath.
• e2studioc not found：检查 e2mcp.e2studioPath 阿普坦多a .../eclipse.
• Cannot find e2-server-gdb：set e2mcp.debugToolsPath 在VS代码设置中。
• No .launch file found：首先在e2 Studio中创建调试启动配置。
• No .mot file found：录制前编译。
• Cannot connect to e2-server-gdb：验证探测器、配置的设备和GDB端口。

许可证

专有软件。保留所有权利。

该存储库的源代码不授予重新分发、分许可或商业利用许可。 扩展包的元数据引用中包含的许可证 vscode扩展名/LICENSE.txt.