azure-mcp-server

一个使用 mcp-framework 构建的模型上下文协议 (MCP) 服务器。

快速开始

# 安装依赖
npm install

# 构建项目
npm run build

项目结构

azure-mcp-server/
├── src/
│   ├── tools/                # MCP 工具
│   │   ├── Storage/      # Azure 存储工具
│   │   │   ├── BaseAzureStorageTool.ts  # Azure 工具的基类
│   │   │   ├── ListContainersTool.ts    # 列出容器
│   │   │   ├── CreateContainerTool.ts   # 创建容器
│   │   │   ├── DeleteContainerTool.ts   # 删除容器
│   │   │   ├── ListBlobsTool.ts         # 列出 Blob
│   │   │   ├── UploadBlobTool.ts        # 上传 Blob
│   │   │   ├── DownloadBlobTool.ts      # 下载 Blob
│   │   │   └── DeleteBlobTool.ts        # 删除 Blob
│   │   └── ExampleTool.ts    # 示例工具模板
│   └── index.ts              # 服务器入口点
├── package.json
└── tsconfig.json

工具开发

示例工具结构

import { MCPTool } from 'mcp-framework';
import { z } from 'zod';

interface MyToolInput {
  message: string;
}

class MyTool extends MCPTool<MyToolInput> {
  name = 'my_tool';
  description = '描述你的工具的功能';

  schema = {
    message: {
      type: z.string(),
      description: '此输入参数的描述'
    }
  };

  async execute(input: MyToolInput) {
    // 你的工具逻辑在这里
    return `Processed: ${input.message}`;
  }
}

export default MyTool;

Azure 存储工具

此 MCP 服务器包含多个用于与 Azure Blob 存储交互的工具，使用 DefaultAzureCredential 进行身份验证。

必需的 Azure 权限

要使用 Azure 存储工具，你需要以下 Azure RBAC 角色：

• 存储帐户参与者: 需要用于列出容器和管理存储帐户设置
• 存储 Blob 数据参与者: 需要用于创建/读取/更新/删除 Blob 和容器

如果没有这些权限，某些操作可能会因授权错误而失败。

身份验证

所有工具都使用来自 @azure/identity 的 DefaultAzureCredential，它按以下顺序尝试多种身份验证方法：

1. 环境变量 (AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET)
2. 托管标识
3. Azure CLI 凭据
4. Visual Studio Code 凭据
5. 交互式浏览器登录（作为备用方案）

确保至少正确配置了其中一种身份验证方法。

可用工具

以下 Azure 存储工具可用：

容器操作

• azure_list_containers: 列出存储帐户中的所有容器
• azure_create_container: 创建一个新容器
• azure_delete_container: 删除一个容器

Blob 操作

• azure_list_blobs: 列出容器中的所有 Blob
• azure_upload_blob: 将 Blob 上传到容器
• azure_download_blob: 下载 Blob 并返回其内容
• azure_delete_blob: 从容器中删除 Blob

使用示例

列出容器

{
  "accountName": "yourstorageaccount"
}

创建容器

{
  "accountName": "yourstorageaccount",
  "containerName": "mycontainer"
}

列出 Blob

{
  "accountName": "yourstorageaccount",
  "containerName": "mycontainer"
}

上传 Blob

{
  "accountName": "yourstorageaccount",
  "containerName": "mycontainer",
  "blobName": "example.txt",
  "content": "This is the content of the blob"
}

下载 Blob

{
  "accountName": "yourstorageaccount",
  "containerName": "mycontainer",
  "blobName": "example.txt"
}

删除 Blob

{
  "accountName": "yourstorageaccount",
  "containerName": "mycontainer",
  "blobName": "example.txt"
}

删除容器

{
  "accountName": "yourstorageaccount",
  "containerName": "mycontainer"
}

调试

如果在使用 Azure 存储工具时遇到问题，请检查控制台日志以获取详细的调试信息。 常见问题包括：

• 身份验证失败
• 缺少权限
• 不存在的容器或 Blob
• 网络连接问题

构建和测试

1. 对你的工具进行更改
2. 运行 npm run build 进行编译
3. 服务器将在启动时自动加载你的工具

了解更多

• MCP Framework Github
• MCP Framework 文档