Arm MCP Server

Arm MCP 服务

一个 MCP 服务，为 AI 助手提供 Arm 架构开发、迁移和优化所需的工具与知识。

使用 Arm MCP 服务

如果您的目标是尽快将应用从 x86 迁移到 Arm，请从这里开始：

使用 Arm MCP 服务自动完成 x86 到 Arm 的应用迁移

功能

此 MCP 服务为 AI 助手提供 Arm 开发专用工具：

• 知识库搜索：对 Arm 文档、学习资源、内建函数和软件兼容性信息进行语义搜索
• 代码迁移分析：使用 migrate-ease 扫描代码库以检查 Arm 兼容性（支持 C++、Python、Go、JavaScript、Java）
• 容器架构检查：使用集成的 Skopeo 和 check-image 工具检查 Docker 镜像的架构支持情况。
• 汇编性能分析：使用 LLVM-MCA 分析汇编代码性能

预构建镜像

如果您想使用预构建的多架构镜像，可在 Docker Hub 找到官方镜像：armlimited/arm-mcp:latest

前置条件

• 支持 Buildx 的 Docker
• 兼容 MCP 的 AI 助手客户端（例如 GitHub Copilot、Kiro CLI、Codex CLI、Claude Code 等）

快速开始

1. 构建 Docker 镜像

在此仓库的根目录下：

docker buildx build -f mcp-local/Dockerfile -t armlimited/arm-mcp . --load

此命令会针对 Docker 主机的原生架构进行构建。发布工作流负责显式的多架构构建。

如需本地开发构建，请参阅 CONTRIBUTING.md 中的“快速本地开发构建”部分。

2. 配置 MCP 客户端

选择与您的 MCP 客户端对应的配置：

Claude Code

将以下内容添加到项目中的 .mcp.json：

{
  "mcpServers": {
    "arm-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--pull=always",
        "-v", "/path/to/your/workspace:/workspace",
        "armlimited/arm-mcp"
      ]
    }
  }
}

GitHub Copilot（VS Code）

将以下内容添加到项目中的 .vscode/mcp.json，或全局添加到 ~/Library/Application Support/Code/User/mcp.json（macOS）：

{
  "servers": {
    "arm-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--pull=always",
        "-v", "/path/to/your/workspace:/workspace",
        "armlimited/arm-mcp"
      ]
    }
  }
}

在 VS Code 中打开此文件进行编辑的最简单方法是按 command+shift+p 并搜索

MCP: Open User Configuration

AWS Kiro CLI

添加到 ~/.kiro/settings/mcp.json：

{
  "mcpServers": {
    "arm-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--pull=always",
        "-v", "/path/to/your/workspace:/workspace",
        "armlimited/arm-mcp"
      ],
      "timeout": 60000
    }
  }
}

Gemini CLI

建议使用项目本地配置文件，以确保挂载相关工作区。

将以下内容添加到项目根目录中的 .gemini/settings.json：

{
  "mcpServers": {
    "arm-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--pull=always",
        "-v", "/path/to/your/workspace:/workspace",
        "armlimited/arm-mcp"
      ]
    }
  }
}

使用 TOML 格式的 MCP 客户端（例如 Codex CLI）

[mcp_servers.arm-mcp]
command = "docker"
args = [
  "run",
  "--rm",
  "-i",
  "--pull=always",
  "-v", "/path/to/your/workspace:/workspace",
  "armlimited/arm-mcp"
]

注意：将 /path/to/your/workspace 替换为您希望 MCP 服务访问的项目目录的实际路径。

3. 重启 MCP 客户端

更新配置后，重启 MCP 客户端以加载 Arm MCP 服务。

日志记录

根据使用情况，服务可能会在 /workspace 下写入两个日志文件。使用上述配置示例时，这些文件会出现在您计算机上的项目目录中：

• mcp-traffic.jsonl 记录工具的使用情况、提供的输入，以及每次工具调用的原因。它还会记录知识库搜索结果。
• error_logging.yaml 记录服务遇到的错误详情。这些信息有助于排查问题。

这些日志可能包含您项目和工具请求中的信息。分享前请检查其内容。

开发与贡献

请参阅 CONTRIBUTING.md，了解仓库结构、集成测试、可复现的构建输入、运行时出站流量验证、依赖项更新和发布工作流。

故障排除

访问容器 Shell

要调试或探索容器环境：

docker run --rm -it --entrypoint /bin/bash armlimited/arm-mcp

常见问题

• 迁移扫描期间超时：在 MCP 客户端配置中增大 timeout 值（例如，"timeout": 120000 表示 2 分钟）
• 工作区为空：确保卷挂载路径正确，且目录存在
• 架构不匹配：确认本地镜像与 Docker 主机的原生架构一致；如需明确指定跨平台构建，请使用发布工作流。

请勿在公开问题中报告疑似漏洞。请参阅 Arm MCP 安全策略，并通过 Arm PSIRT 报告。

许可证

版权所有 © 2026，Arm Limited 和贡献者。保留所有权利。

根据 Apache License, Version 2.0 许可。详情请参阅 LICENSE。