MCP

🚀 Arm MCP Server

Model Context Protocol (MCP)サーバーです。このサーバーは、AIアシスタントにArmアーキテクチャの開発、移行、最適化に必要なツールと知識を提供します。

✨ 主な機能

このMCPサーバーは、AIアシスタントにArm開発用の専用ツールを備えています。

• 知識ベース検索：Armのドキュメント、学習リソース、組み込み関数、ソフトウェア互換性情報を対象とした意味検索
• コード移行分析：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、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に追加するか、グローバルに（macOSの場合は~/Library/Application Support/Code/User/mcp.json）追加します。

{
  "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/：ソースドキュメントから知識ベースを再生成するためのスクリプト

トラブルシューティング

コンテナシェルへのアクセス

コンテナ環境をデバッグまたは探索するには：

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

一般的な問題

• 移行スキャン中のタイムアウトエラー：MCPクライアントの設定でtimeout値を増やします（例：2分の場合は"timeout": 120000）
• ワークスペースが空の場合：ボリュームマウントパスが正しく、ディレクトリが存在することを確認してください。
• アーキテクチャの不一致：プラットフォーム固有の問題が発生した場合は、--platform linux/amd64または--platform linux/arm64を使用して、特定のプラットフォーム用に再ビルドします。

🤝 コントリビューション

コントリビューションは大歓迎です！問題やプルリクエストを自由に提出してください。

コントリビュートする際は：

• PythonコードについてはPEP 8スタイルガイドラインに従ってください。
• 新機能や変更があった場合はドキュメントを更新してください。
• 提出する前にDockerイメージが正常にビルドされることを確認してください。

📄 ライセンス

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

Apache License, Version 2.0の下でライセンスされています。詳細はLICENSEを参照してください。