MCP 服务器

Azure MCP Server

通过 Claude Desktop 实现与 Azure 服务的自然语言交互，支持资源管理、订阅处理和租户选择，并提供安全身份验证。

Tools

run-azure-code

Run Azure code

list-tenants

List all available Azure tenants

select-tenant

Select Azure tenant and subscription

README

Azure MCP (模型上下文协议) for Claude Desktop

一个模型上下文协议 (MCP) 的实现，使 Claude Desktop 能够与 Azure 服务交互。此集成允许 Claude 通过自然语言对话直接查询和管理 Azure 资源。

特性

Azure 资源管理: 与 Azure 资源管理客户端交互
订阅管理: 列出和管理 Azure 订阅
租户管理: 列出和选择 Azure 租户
自动身份验证: 利用 DefaultAzureCredential 实现灵活的身份验证方法
错误处理: 强大的错误处理，对瞬时故障进行重试
清晰的响应格式: 格式正确的响应，与 Claude Desktop 兼容

前提条件

Node.js (v18 或更高版本)
Claude Desktop 应用程序
具有适当权限的 Azure 帐户
Azure CLI (可选，用于基于 CLI 的身份验证)

安装

手动安装

克隆存储库:

git clone https://github.com/Streen9/azure-mcp.git
cd azure-mcp

安装依赖项:

npm install

配置 Claude Desktop:
- 打开 claude_desktop_config.json
- 添加以下 MCP 配置:

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "azure": {
      "command": "tsx",
      "args": [
        "C:/Users/[YourUsername]/path/to/azure-mcp/src/launcher.ts"
      ]
    }
  }
}

身份验证

该服务器通过 DefaultAzureCredential 支持多种身份验证方法:

环境变量
托管标识
Azure CLI
Visual Studio Code
交互式浏览器

服务器将自动按顺序尝试这些方法，直到其中一种成功。

用法

如果 Claude Desktop 正在运行，请关闭它 (检查任务管理器)
启动 Claude Desktop
在聊天中，您现在可以提出与 Azure 相关的问题，例如:
- "你能获取所有可用的 Azure 帐户和订阅吗?"
- "列出我的订阅中的所有资源组"
- "显示特定资源组中的所有虚拟机"

示例对话

你: 你能获取所有可用的 Azure 帐户和订阅吗?
Claude: 我将帮助您列出所有可用的 Azure 租户和订阅。
[Claude 将使用 Azure MCP 来获取和显示信息]

开发

项目结构

azure-mcp/
├── src/
│   ├── launcher.ts       # 服务器入口点
│   ├── AzureServer.ts    # 主要 MCP 服务器实现
│   └── LoggerService.ts  # 日志记录实用程序
├── package.json
└── README.md

主要组件

AzureMCPServer: 实现 MCP 协议的主要服务器类
HandleCallTool: 处理传入的工具请求
ExecuteWithRetry: 实现用于弹性操作的重试逻辑

故障排除

身份验证问题:
- 确保您已通过 Azure CLI 登录 (az login)
- 如果使用服务主体，请检查环境变量
- 验证您的 Azure 帐户是否具有必要的权限
连接问题:
- 验证 Claude Desktop 配置
- 检查配置文件中的路径是否与您的安装匹配
- 确保没有其他实例正在运行
常见错误:
- NO_TENANT: 使用 'select-tenant' 工具选择一个租户
- NO_CLIENTS: 确保正确初始化和身份验证
- CODE_EXECUTION_FAILED: 检查 Azure 权限和连接