GA

geekychris/amiga_mcp

部署与 DevOps

本页由 AI 翻译,技术细节请以原文为准。 查看原文

51 stars 7 forks 质量 61 趋势 34MIT

该项目 Amiga DevBench 是一个跨开发环境,通过串口连接现代主机与模拟或真实 Amiga,提供实时调试、内存检查和完整的 MCP......

概览

一个面向 Commodore Amiga(68k)的跨开发环境,通过串口将现代主机连接到模拟(或真实)Amiga,提供实时调试、内存检查、变量编辑、远程执行以及与 Claude Code 的完整 MCP 集成。 Brew风格安装程序——获取源代码,安装Python主机服务器,拉取m68k Docker交叉编译器,构建桥梁守护进程+示例,并在http://localhost:3000.启动网页界面,重新运行后拉取最新提交并重新构建。 安装程序需要git、python>=3.10和Docker。在Mac/Linux上,你可以选择自动安装缺少的CLI工具,且设置为AMIGA_MCP_AUTO_INSTALL=1。macOS/Windows上的Docker Desktop无论如何都需要GUI安装。 FS-UAE 本身(你需要 Kickstart ROM — 参见 FS-UAE 模拟器设置)。可选的带有 HTTP 调试器的补丁 fs-uae 分支通过 AMIGA_MCP_BUILD_PATCHED=1(Linux + macOS)选择加入。

概述(AI 翻译)

–>

Amiga 开发版

从现代计算机开发Amiga软件。DevBench提供网页 用于构建程序、传输文件和运行的仪表盘和MCP工具 AmigaDOS 执行命令并检查模拟或真实的 Amiga。

新来的?安装并验证DevBench。 该指南基于现有的结账点,并以模拟器为基础,所以 你可以在设置Amiga之前验证主机安装。

你需要什么

  • 主机服务器: Python 3.10+ 和 Git,适用于 macOS、Linux 或 Windows。
  • **真实目标:**运行你自己的ROM/操作系统的模拟器,或运行的Amiga。 amiga-bridge 访客程序。模拟器两者都不需要。
  • 编译Amiga程序: Docker 及相应的交叉编译器 图片。Docker 不仅仅是安装 Python 服务器或检查时需要的 目标有现有的桥梁。

设置三个命令

可以从全屏菜单中选择机器(经典Amiga,AmigaOS 4, Atari ST和3DO),运行make retro。它运行Retro Launcher,来自 ../retro-launcher。

Kickstart ROM 和 AmigaOS 3.x / 4.1 安装都是商业版的,所以 doctor.sh 不断报告,直到它们都到位;它说明了每个位置 去了。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Amiga DevBench

Develop Amiga software from a modern computer. DevBench provides a web dashboard and MCP tools for building programs, transferring files, running AmigaDOS commands and inspecting an emulated or real Amiga.

New here? Install and verify DevBench. The guide works from an existing checkout and starts with a simulator, so you can verify the host installation before setting up an Amiga.

What you need

  • Host server: Python 3.10+ and Git, on macOS, Linux or Windows.
  • A real target: an emulator with your own ROM/OS, or an Amiga, running the amiga-bridge guest program. The simulator needs neither.
  • Compiling Amiga programs: Docker and the appropriate cross-compiler image. Docker is not needed just to install the Python server or inspect a target with an existing bridge.

Setup in three commands

scripts/setup.sh     # install everything that can be installed (68k, os4 or both)
scripts/doctor.sh    # check every prerequisite; each problem comes with its fix
scripts/start.sh     # start the emulators + devbenches, wait until the Amigas answer

To pick a machine from a full-screen menu instead (classic Amiga, AmigaOS 4, Atari ST and 3DO), run make retro. It runs the Retro Launcher from ../retro-launcher.

The Kickstart ROM and the AmigaOS 3.x / 4.1 installs are commercial, so doctor.sh keeps reporting them until they’re in place; it says where each goes. The scripts are bash: on Windows, use WSL (or scripts/install.ps1). See SETUP.md for the one-page guide.

The current server is in amiga-devbench/ (Python). The mcp-server/ TypeScript project and amiga-debug-lib/ are deprecated.

Start here

I want to… Read
Set up and start everything with the scripts SETUP.md
Install from a checkout and verify it works Installation guide
Connect Codex CLI or Claude Code MCP client setup
Use WinUAE or FS-UAE Dual-emulator setup
Connect an emulator or physical Amiga Target setup
Set up AmigaOS 4.1 on QEMU AmigaOS 4 setup
Use WinUAE native debugging WinUAE debugger
Choose between guest and emulator debugging Debugger guide
Find a tool or API Documentation index

How it fits together

Codex / Claude Code ── MCP over HTTP ──┐
                                     ├── DevBench ── serial/TCP ── amiga-bridge
Web browser ───────── HTTP ───────────┘                              (Amiga)

The dashboard is at http://localhost:3000/; the MCP endpoint is http://localhost:3000/mcp. scripts/start.sh runs one DevBench per target:

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →