Gw Synth Flash MCP

gw合成器flash mcp

 

一个非官方的MCP（模型上下文协议）服务器，它公开了一些Gowin IDE CLI工作流作为工具。

• 后端：Rust+ rmcp
• 提供MCP工具（工具名称保留为 gowin.* 为了兼容性）
• 当前目标操作系统：macOS

日语自述： README_JA.md

回购布局（假设）

此存储库旨在成为一个独立的Rust机箱：

• src/：MCP服务器实现
• examples/：MCP客户端配置模板
• target/：构建工件（生成；未跟踪）

先决条件

• macOS上已安装Gowin IDE

- 默认位置： /Applications/GowinIDE.app - 如果不同：通过 gowin_ide_app_path 刀具参数

安装

从crates.io安装：

cargo install gw-synth-flash-mcp

从源代码构建（用于开发）

cargo build --release

可选：从本地源安装：

cargo install --path .

运行（stdio）

./target/release/gw-synth-flash-mcp

或者，如果已安装：

gw-synth-flash-mcp

此服务器根据 project_root.

优先级顺序：

1. 每个刀具参数： project_root
2. 环境变量： GOWIN_MCP_PROJECT_ROOT
3. 自动检测 cwd 通过向上搜索 run_gowin.tcl 或 *.gprj
4. 退路： cwd

例子：

export GOWIN_MCP_PROJECT_ROOT="/ABS/PATH/TO/your/gowin/project"
./target/release/gw-synth-flash-mcp

快速开始

1. 安装

cargo install gw-synth-flash-mcp

1. 将您的MCP客户端（例如，VS代码/复制副本）指向已安装的二进制文件

• 例子： gw-synth-flash-mcp （如果安装在 $PATH)
• 或者： ${workspaceFolder}/target/release/gw-synth-flash-mcp （如果从源代码构建）

1. 集 GOWIN_MCP_PROJECT_ROOT （或通行证 project_root 每次工具调用）

VS代码（GitHub Copilot）模板

模板： examples/vscode.mcp.json

• 如果通过安装 cargo install：使用 gw-synth-flash-mcp 命令
• 如果从源代码构建：使用 ${workspaceFolder}/target/release/gw-synth-flash-mcp
• 集 GOWIN_MCP_PROJECT_ROOT 转到您的Gowin项目目录

Claude代码模板

模板： examples/claude-code.mcp.json

• 绝对路径模板（替换 /ABS/PATH/... 值）

工具

gowin.run_tcl

• 通过运行Tcl gw_sh
• 提供其中之一 tcl_path （文件）或 tcl_inline （字符串）
• 如果 project_root 已设置，在其下解析相对路径

gowin.list_cables

• 通过以下方式枚举可用的编程器电缆 programmer_cli （尝试多种列表模式）

gowin.program_fs

• 程序a .fs 通过以下方式将比特流传输到SRAM programmer_cli
• 如果 cable 如果省略，它会自动从中选择 list_cables
• 如果需要，它会使用不同的电缆推理策略重试

日志

每个工具调用都会在以下位置写入日志 /.gowin-mcp/logs/:

• *.log：组合stdout/stderr
• *.json：执行元数据（退出代码、持续时间、参数等）

安全/免责声明

• 这是非官方软件，与Gowin无关。
• 编程硬件会影响FPGA/板。使用风险自负。