@azure/mcp-darwin-arm64 weekly downloads statistics

<img height="36" width="36" src="https://cdn-dynmedia-1.microsoft.com/is/content/microsoftcorp/acom_social_icon_azure" alt="Microsoft Azure Logo" /> Azure MCP Server NPM Package

All Azure MCP tools in a single server. The Azure MCP Server implements the MCP specification to create a seamless connection between AI agents and Azure services. Azure MCP Server can be used alone or with the GitHub Copilot for Azure extension in VS Code.

Table of Contents

• Overview
• Local Setup
• Remote Setup
• Usage
  • Getting Started
  • Sovereign Cloud Support
  • What can you do with the Azure MCP Server?
  • Complete List of Supported Azure Services
• Support and Reference
  • Documentation
  • Feedback and Support
  • Security
  • Permissions and Risk
  • Data Collection
  • Compliance Responsibility
  • Third Party Components
  • Export Control
  • No Warranty / Limitation of Liability
  • Contributing
  • Code of Conduct

Overview

Azure MCP Server supercharges your agents with Azure context across numerous Azure services.

Local Setup

• To use Azure MCP server from node one must have Node.js (LTS) installed and available on your system PATH — this provides both npm and npx. We recommend the latest Node.js LTS version. To verify your installation run: node --version, npm --version, and npx --version.

• Configure the mcp.json file with the following:

  {
      "mcpServers": {
          "azure-mcp-server": {
          "command": "npx",
          "args": [
              "-y",
              "@azure/mcp@latest",
              "server",
              "start"
              ]
          }
      }
  }
  

Note: When manually configuring Visual Studio and Visual Studio Code, use servers instead of mcpServers as the root object.

Client-Specific Configuration

IDE	File Location	Documentation Link
VS Code	.vscode/mcp.json (workspace)<br>settings.json (user)	VS Code MCP Documentation
Visual Studio	.mcp.json (solution/workspace)	Visual Studio MCP Setup
GitHub Copilot CLI	~/.copilot/mcp-config.json	Copilot CLI MCP Configuration
Claude Code	~/.claude.json or .mcp.json (project)	Claude Code MCP Configuration
Eclipse IDE	GitHub Copilot Chat -> Configure Tools -> MCP Servers	Eclipse MCP Documentation
IntelliJ IDEA	Built-in MCP server (2025.2+)<br>Settings > Tools > MCP Server	IntelliJ MCP Documentation
Google Antigravity	~/.gemini/config/mcp_config.json (global)<br>.agents/mcp_config.json (workspace)	Google Antigravity MCP Documentation
Cursor	~/.cursor/mcp.json or .cursor/mcp.json	Cursor MCP Documentation
Windsurf	~/.codeium/windsurf/mcp_config.json	Windsurf Cascade MCP Integration
Amazon Q Developer	~/.aws/amazonq/mcp.json (global)<br>.amazonq/mcp.json (workspace)	AWS Q Developer MCP Guide
Claude Desktop	~/.claude/claude_desktop_config.json (macOS)<br>%APPDATA%\Claude\claude_desktop_config.json (Windows)	Claude Desktop MCP Setup

Remote Setup

Host the Azure MCP Server as a remote endpoint when your client requires HTTP-based MCP servers (for example, Microsoft Foundry and Microsoft Copilot Studio) or when you want to share a single deployment across users and environments. The server can be self-hosted on Azure Container Apps.

See the remote hosting azd templates for deployment options.

Usage

Getting Started…