ARM验证MCP服务器
此存储库包含四个MCP stdio服务器，用于ARM规范、验证、组装分析和性能检查。
最近增加的内容包括：
validate_smt_clause在存储之前检查单个SMT-LIB子句；diff_spec_versions比较两个存储的规范修订版；wait_for_verification轮询验证作业以完成；get_counterexample_excerpt以检索存储模型的第一行。
这些MCP服务器是为谁准备的
这些服务器在以下方面最有用：
- LLM代理和MCP主机 这需要面向ARM的结构化工具，而不仅仅是自由形式的推理。
- 固件和低级工程师 他们希望快速检查ARM控制流、寄存器效果、循环候选和指令语义。
- 形式化方法和验证工作流程 这需要从存储的规范到Z3支持的验证尝试的轻量级路径。
- 绩效和恒定时间审查工作流程 这需要快速的时间预算和秘密相关的控制流检查。
- 安全审查员 他们想要一个可重复的MCP表面来检查恒定时间假设和验证失败。
- 工具和平台团队 围绕ARM组装和正式规范构建内部副驾驶、CI助手或分析机器人。
典型用例包括：
- 为函数创建和版本化正式规范，例如
fibonacci或strlen_arm; - 启动并检查存储的规范版本的验证作业；
- 在逆向工程或代码审查期间分析小的ARM代码片段；
- 检查功能是否保持在周期预算内；
- 比较基线和候选绩效结果；
- 为MCP客户端提供了一个用于ARM推理的确定性、工具支持的工作流。
构建
从存储库根目录：
bun installbun run buildnpm run build
编译后的服务器入口点将写入 build/.
通用 mcpServers 配置
将其用作支持以下功能的MCP主机的便携式基线 mcpServers, command, args，以及 cwd:
{
"mcpServers": {
"arm-specification": {
"command": "node",
"args": ["/Volumes/External/Code/f3mcp/build/specification.js"],
"cwd": "/Volumes/External/Code/f3mcp"
},
"arm-verification": {
"command": "node",
"args": ["/Volumes/External/Code/f3mcp/build/verification.js"],
"cwd": "/Volumes/External/Code/f3mcp"
},
"arm-assembly": {
"command": "node",
"args": ["/Volumes/External/Code/f3mcp/build/assembly.js"],
"cwd": "/Volumes/External/Code/f3mcp"
},
"arm-performance": {
"command": "node",
"args": ["/Volumes/External/Code/f3mcp/build/performance.js"],
"cwd": "/Volumes/External/Code/f3mcp"
}
}
}备注
- 这些服务器是基于stdio的，应该由您的MCP主机启动。
cwd因为服务器读写很重要data/*.json相对于回购根。- 如果您的MCP主机忽略
cwd，服务器可能找不到data/目录正确。
测试命令
从存储库根目录：
npm testnode --test test/*.test.mjsnode --test test/strlen-arm-verification.test.mjs
该测试套件包括所有四台服务器的MCP stdio端到端覆盖、验证单元覆盖和专用 strlen_arm 场景套件。
冷启动提示
在连接服务器后立即在MCP主机中使用这些提示。
冷启动的最佳模式是将提示分为两种模式：
- 严格的烟雾提示：验证接线、工具布线和基本有效载荷质量；
- 探索性提示：确认接线后，请进行更全面的解释。
对于下面的严格提示，请选择以下规则：
- 在可能的情况下，要求主机仅使用MCP工具输出；
- 让它列出它实际调用的工具；
- 要求它不要做出假设，除非它明确地将其标记为假设；
- 要求简短、结构化的答案，以便精简的MCP客户端保持可读性。
一次严格的烟雾测试
问主持人：
Smoke test all connected ARM MCP servers. List the available tools for specification, verification, assembly, and performance. Then run one safe example call per server. Return only: (1) tools discovered, (2) tools actually used, (3) pass/fail per server, (4) short notes on any missing structured output.
2.规范服务器严格烟雾测试
问主持人：
Use only the specification MCP tools. Create a formal specification for sum_positive with preconditions ['(> x 0)', '(> y 0)'], postconditions ['(> (+ x y) 0)'], and invariants ['(>= x 1)', '(>= y 1)']. Then validate the spec and list all known versions. Return only: tools used, created version, validation result, and version list.
3.验证服务器严格烟雾测试
问主持人：
Use only the verification MCP tools. Start verification for function 'sum_positive' spec version 1. Then fetch the verification status and explanation. Return only: tools used, job ID, function name, spec version, job status, solver status, whether a counterexample exists, and the final one-line verdict.
4.组装服务器严格烟雾测试
问主持人：
Use only ARM assembly MCP tools for this task. Do not rely on prior knowledge unless the tool output is missing something, and if so say that explicitly. Analyze this snippet: 'loop:\nLDR x1, [x2]\nADD x0, x0, x1\nSTR x0, [x3]\nCBNZ x0, loop\nRET'. Return only: (1) tools used, (2) control-flow summary, (3) registers read/written, (4) memory read/write effects, (5) likely loops/back-edges, (6) one-sentence explanation of ADD.
5.性能服务器严格烟雾测试
问主持人：
Use only ARM performance MCP tools for this task. Run checks for function 'fast_fn' with observedCycles=90, maxCycles=100, baselineCycles=100, candidateCycles=95, branchOnSecret=false, memoryOnSecret=false. Return only: (1) tools used, (2) timing budget pass/fail, (3) cycle delta and percentage, (4) constant-time pass/fail, (5) final one-line verdict.
6.斐波那契严格冷启动提示
问主持人：
Use only the specification and verification MCP tools. Do not include process narration. Create a formal SMT-LIB specification for fibonacci with preconditions ['(>= n 0)', '(= result 0)', '(= 0，服务器应返回VALIDATION_FAILED带有SMT-LIB格式化提示。
7. strlen_arm 严格的冷启动提示
问主持人：
Use only the specification and verification MCP tools. Create or inspect the stored specification for strlen_arm, then verify practical scenarios for empty string, one-character ASCII, embedded NUL, UTF-8 byte counting, offset 0/1/2/3 alignment, and a 4096-byte input. Return only: tools used, spec versions touched, scenario-to-version mapping, pass/fail per scenario, and final summary.
8.错误路径烟雾提示
问主持人：
Deliberately try to create a bad specification for fibonacci using natural language clauses like 'n must be non-negative' and 'result is fibonacci of n'. Show the returned validation error, then rewrite the clauses into valid SMT-LIB and retry. Return only: tools used, original validation error, corrected clauses, and retry result.
9.探索性组装提示
问主持人：
Analyze this ARM snippet: 'loop:\nLDR x1, [x2]\nADD x0, x0, x1\nSTR x0, [x3]\nCBNZ x0, loop\nRET'. After using the ARM assembly tools, give a concise explanation of behavior, likely loop semantics, register/memory effects, and a short pseudocode summary.
10.探索性表现提示
问主持人：
Check timing constraints for function 'fast_fn' with observedCycles 90 and maxCycles 100. Then compare baselineCycles 100 vs candidateCycles 95 and verify constant-time assumptions with branchOnSecret=false and memoryOnSecret=false. After calling the performance tools, summarize the practical meaning of the results.
这些提示对于不自动呈现的MCP客户端特别有用 structuredContent，因为服务器现在在正常的工具响应中包含了更多人类可读的状态和解释文本。
单个服务器入口点
node build/specification.jsnode build/verification.jsnode build/assembly.jsnode build/performance.js
验证输入指南
有关验证服务器使用的有效SMT-LIB示例，请参阅：
src/verification.md
核证附注
- 验证服务器更喜欢Homebrew的Z3系统
/opt/homebrew/bin/z3那么/usr/local/bin/z3那么z3从PATH. - 您可以使用以下命令显式覆盖求解器路径
Z3_BINARY=/absolute/path/to/z3. SOLVER_UNAVAILABLE意味着服务器无法启动求解器进程。VALIDATION_FAILED表示Z3已启动，但拒绝了提交的SMT-LIB输入。
strlen_arm 验证场景
该存储库现在包括一个专用的验证套件，用于实用 strlen_arm 案例：
test/strlen-arm-verification.test.mjs
它包括：
- 空字符串
- 一个字符ASCII字符串
- 短ASCII字符串
- 带空格和标点符号的字符串
- 早
NUL在更大的缓冲区内终止 - UTF-8字节计数行为
- 起始指针偏移
0,1,2，以及3 - 4096字节的输入
- 分配缓冲区最后一个字节中的终止符