Z80指令参考服务器

提供结构化Z80指令数据的MCP服务器,支持精确查找、结构化搜索和操作码查找,适用于AI代理、模拟器和反汇编工具开发者。

  • by moroz1999
  • HTML
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 moroz1999/zx-mcp

使用说明

zx mcp

MCP服务器具有结构化的Z80指令参考数据集。

这个服务器是什么

zx-mcp 为AI代理提供确定性的Z80指令数据。 它支持在SQLite支持的索引上进行精确查找、结构化搜索和操作码/前缀查找。

这是给谁的

  • 需要可靠Z80指令答案的AI代理用户
  • 需要结构化查找数据的仿真器/反汇编工具作者
  • 开发人员围绕Z80指令知识构建基于MCP的工作流程

在本地运行

  1. 安装依赖项:
npm install
  1. 从导入源数据集 https://clrhome.org/table/:
npm run import:clrhome
  1. 构建服务器:
npm run build
  1. 启动MCP服务器(stdio传输):
node dist/interfaces/mcp/server.js

默认情况下,服务器使用 data/z80.sqlite. ZX_MCP_DB_PATH 是可选的,仅需要自定义数据库路径。

以VS代码连接(聊天/代理模式)

  1. 在VS Code中打开工作区。
  2. 跑 MCP: Open Workspace Folder Configuration 从命令面板。
  3. 把这个加进去 .vscode/mcp.json:
{
  "servers": {
    "zxMcp": {
      "type": "stdio",
      "command": "node",
      "args": [
        "dist/interfaces/mcp/server.js"
      ],
      "cwd": "/path/to/zx-mcp/"
    }
  }
}
  1. 跑 MCP: List Servers,选择 zxMcp,并启动/启用它。
  2. 在聊天/代理模式下,使用服务器工具:
    • instruction_lookup_exact
    • instruction_search
    • instruction_lookup_opcode

Codex中的连接(以及VS Code的Codex扩展)

添加 ~/.codex/config.toml:

[mcp_servers.zxMcp]
command = "node"
args = ["dist/interfaces/mcp/server.js"]
cwd = "/path/to/zx-mcp/"