Arm MCP Server

Arm MCP Server

Arm アーキテクチャの開発、移行、最適化に役立つツールとナレッジを AI アシスタントに提供する MCP サーバーです。

Arm MCP Server の使用

アプリケーションを x86 から Arm にできるだけ早く移行することが目標であれば、こちらから始めてください。

Arm MCP Server を使用して x86 から Arm へのアプリケーション移行を自動化する

機能

この MCP サーバーは、Arm 開発向けの専門的なツールを AI アシスタントに提供します。

• ナレッジベース検索：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 の「Quick Local Development Builds」セクションを参照してください。

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: ユーザー設定を開く

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 クライアントを再起動する

設定を更新したら、Arm MCP サーバーを読み込むために MCP クライアントを再起動してください。

ログ

使用状況に応じて、サーバーは /workspace に 2 つのログファイルを書き込む場合があります。上記の設定例では、これらのファイルはコンピューター上のプロジェクトディレクトリに作成されます。

• mcp-traffic.jsonl には、ツールの使用時刻、指定された入力、各ツール呼び出しの理由が記録されます。また、ナレッジベース検索の結果も記録されます。
• error_logging.yaml には、サーバーで発生したエラーの詳細が記録されます。この情報はトラブルシューティングに役立ちます。

これらのログには、プロジェクトやツールリクエストに関する情報が含まれる場合があります。共有する前に内容を確認してください。

開発とコントリビューション

リポジトリの構造、統合テスト、再現可能なビルド入力、実行時の外部通信の検証、依存関係の更新、リリースワークフローについては、CONTRIBUTING.md を参照してください。

トラブルシューティング

コンテナのシェルにアクセスする

コンテナ環境をデバッグまたは確認するには、次を実行します。

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

よくある問題

• 移行スキャン中のタイムアウトエラー：MCP クライアントの設定で timeout の値を大きくしてください（例：2 分の場合は "timeout": 120000）。
• ワークスペースが空の場合：ボリュームのマウントパスが正しく、ディレクトリが存在することを確認してください。
• アーキテクチャの不一致：ローカルイメージが Docker ホストのネイティブアーキテクチャに合っていることを確認してください。明示的なクロスプラットフォームビルドには、リリースワークフローを使用してください。

脆弱性の疑いがあるものを公開のイシューで報告してはいけません。Arm MCP セキュリティポリシーを確認し、Arm PSIRTを通じて報告してください。

ライセンス

Copyright © 2026, Arm Limited and Contributors. All rights reserved.

Apache License, Version 2.0 に基づいてライセンスされています。詳細は LICENSE をご覧ください。