MCP

🚀 Arm MCP 服务器

Arm MCP 服务器基于 模型上下文协议（MCP），为 AI 助手提供用于 Arm 架构开发、迁移和优化的工具与知识。

✨ 主要特性

此 MCP 服务器为 AI 助手配备了用于 Arm 开发的专业工具：

• 知识库搜索：对 Arm 文档、学习资源、内联函数和软件兼容性信息进行语义搜索。
• 代码迁移分析：使用 [migrate - ease](https://github.com/migrate - ease/migrate - ease) 扫描代码库的 Arm 兼容性（支持 C++、Python、Go、JavaScript、Java）。
• 容器架构检查：使用集成的 Skopeo 和 check - image 工具检查 Docker 镜像的架构支持情况。
• 汇编性能分析：使用 LLVM - MCA 分析汇编代码的性能。
• 系统信息：通过 sysreport 收集详细系统架构信息的说明。

📦 安装指南

预构建镜像

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

前提条件

• Docker（具备用于多架构构建的 buildx 支持）
• 兼容 MCP 的 AI 助手客户端（例如 GitHub Copilot、AWS Kiro CLI、Codex CLI、Claude Code 等）

快速开始

1. 构建 Docker 镜像

从本仓库的根目录执行以下命令：

docker buildx build --platform linux/arm64,linux/amd64 -f mcp-local/Dockerfile -t arm-mcp mcp-local

若进行单平台构建（速度更快）：

docker buildx build -f mcp-local/Dockerfile -t arm-mcp mcp-local

2. 配置您的 MCP 客户端

选择与您的 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",
        "-v", "/path/to/your/workspace:/workspace",
        "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",
        "-v", "/path/to/your/workspace:/workspace",
        "--name", "arm-mcp",
        "arm-mcp"
      ],
      "timeout": 60000
    }
  }
}

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

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

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

3. 重启您的 MCP 客户端

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

📚 详细文档

仓库结构

• mcp - local/：MCP 服务器的实现
  • server.py：带有工具定义的主 FastMCP 服务器
  • utils/：每个工具的辅助模块
  • data/：预构建的知识库（嵌入和元数据）
  • Dockerfile：多阶段 Docker 构建
• embedding - generation/：用于从源文档重新生成知识库的脚本

🔧 技术细节

故障排除

访问容器 shell

要调试或探索容器环境，请执行以下命令：

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

常见问题

• 迁移扫描期间出现超时错误：增加 MCP 客户端配置中的 timeout 值（例如，将 "timeout": 120000 设置为 2 分钟）。
• 工作区为空：确保您的卷挂载路径正确且目录存在。
• 架构不匹配：如果遇到特定平台的问题，请使用 --platform linux/amd64 或 --platform linux/arm64 为您的特定平台重新构建。

🤝 贡献

欢迎贡献代码！请随时提交问题或拉取请求。 贡献时请遵循以下规则：

• 遵循 Python 代码的 PEP 8 风格指南。
• 为任何新功能或更改更新文档。
• 在提交前确保 Docker 镜像构建成功。

📄 许可证

版权所有 © 2025，Arm Limited 及其贡献者。保留所有权利。 本项目采用 Apache 许可证 2.0 版。详情请参阅 LICENSE。