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。