使用说明
zx mcp
MCP服务器具有结构化的Z80指令参考数据集。
这个服务器是什么
zx-mcp 为AI代理提供确定性的Z80指令数据。
它支持在SQLite支持的索引上进行精确查找、结构化搜索和操作码/前缀查找。
这是给谁的
- 需要可靠Z80指令答案的AI代理用户
- 需要结构化查找数据的仿真器/反汇编工具作者
- 开发人员围绕Z80指令知识构建基于MCP的工作流程
在本地运行
- 安装依赖项:
npm install
- 从导入源数据集
https://clrhome.org/table/:
npm run import:clrhome
- 构建服务器:
npm run build
- 启动MCP服务器(stdio传输):
node dist/interfaces/mcp/server.js
默认情况下,服务器使用 data/z80.sqlite.
ZX_MCP_DB_PATH 是可选的,仅需要自定义数据库路径。
以VS代码连接(聊天/代理模式)
- 在VS Code中打开工作区。
- 跑
MCP: Open Workspace Folder Configuration从命令面板。 - 把这个加进去
.vscode/mcp.json:
{
"servers": {
"zxMcp": {
"type": "stdio",
"command": "node",
"args": [
"dist/interfaces/mcp/server.js"
],
"cwd": "/path/to/zx-mcp/"
}
}
}
- 跑
MCP: List Servers,选择zxMcp,并启动/启用它。 - 在聊天/代理模式下,使用服务器工具:
instruction_lookup_exactinstruction_searchinstruction_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/"
