arm-reference

ARM Reference MCP Suite

A collection of Model Context Protocol (MCP) servers that give AI assistants instant access to ARM architecture reference data, cloud migration guidance, documentation search, and edge AI deployment planning.

The suite includes 4 MCP servers with 44 tools total:

MCP Server	Tools	Description
ARM Register Reference	23	Core architecture reference: registers, instructions, calling conventions, exception levels, security, page tables, NEON/SME, optimization, and more
ARM Documentation RAG	7	Search and explain ARM architecture documentation, errata, manual references, and instruction encodings
ARM Cloud Migration Advisor	7	Analyze dependencies, Docker images, Dockerfiles, benchmarks, and infrastructure for x86-to-ARM cloud migration
ARM TinyML & Edge AI	7	Plan and optimize ML model deployment on Cortex-M, Cortex-A, Ethos NPU, and edge AI accelerators

Built in Python. Works with any MCP-compatible client over stdio transport.

Documentation

---

Installation

Prerequisites

Python 3.10+ and either uv (recommended) or pip. Distributed via GitHub (not PyPI).

Claude Code (CLI)

Route 1: Add as standalone MCP servers

Using uvx (no permanent install required):

# ARM Register Reference (23 tools)
claude mcp add --transport stdio arm-reference -- uvx --from "git+https://github.com/yerry262/arm-reference-mcp.git" arm-reference-mcp

# ARM Documentation RAG (7 tools)
claude mcp add --transport stdio arm-docs-rag -- uvx --from "git+https://github.com/yerry262/arm-reference-mcp.git" arm-docs-rag-mcp

# ARM Cloud Migration Advisor (7 tools)
claude mcp add --transport stdio arm-cloud-migration -- uvx --from "git+https://github.com/yerry262/arm-reference-mcp.git" arm-cloud-migration-mcp

# ARM TinyML & Edge AI (7 tools)
claude mcp add --transport stdio arm-tinyml -- uvx --from "git+https://github.com/yerry262/arm-reference-mcp.git" arm-tinyml-mcp

Or install with pip first, then add:

pip install "git+https://github.com/yerry262/arm-reference-mcp.git"
claude mcp add --transport stdio arm-reference -- arm-reference-mcp
claude mcp add --transport stdio arm-docs-rag -- arm-docs-rag-mcp
claude mcp add --transport stdio arm-cloud-migration -- arm-cloud-migration-mcp
claude mcp add --transport stdio arm-tinyml -- arm-tinyml-mcp

Route 2: Add as a plugin via Claude Code marketplace

/plugin marketplace add yerry262/arm-reference-mcp
/plugin install arm-reference-mcp

This auto-configures all MCP servers based on .mcp.json and .claude-plugin/plugin.json.

VS Code (GitHub Copilot / Continue.dev)

Create or edit .vscode/mcp.json in your workspace root:

{
  "mcpServers": {
    "arm-reference": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/yerry262/arm-reference-mcp.git", "arm-reference-mcp"]
    }
  }
}

Or add to your VS Code user settings.json:

{
  "mcp": {
    "servers": {
      "arm-reference": {
        "type": "stdio",
        "command": "uvx",
        "args": ["--from", "git+https://github.com/yerry262/arm-reference-mcp.git", "arm-reference-mcp"]
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "arm-reference": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/yerry262/arm-reference-mcp.git", "arm-reference-mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "arm-reference": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/yerry262/arm-reference-mcp.git", "arm-reference-mcp"]
    }
  }
}

OpenAI Codex CLI

Add to your Codex MCP config (see Codex CLI docs for the config file location):

{
  "mcpServers": {
    "arm-reference": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/yerry262/arm-reference-mcp.git", "arm-reference-mcp"]
    }
  }
}

Generic / Other MCP Clients

Any MCP-compatible client can connect over stdio transport:

uvx --from "git+https://github.com/yerry262/arm-reference-mcp.git" arm-reference-mcp

Or install and run directly:

pip install "git+https://github.com/yerry262/arm-reference-mcp.git"
arm-reference-mcp

No HTTP server or port configuration needed.

---

ARM Register Reference MCP

The primary MCP server providing 23 tools for ARM architecture reference, organized into six categories.

Register tools