Lokka

Lokka 是一个用于 Microsoft Graph 和 Azure RM API 的模型-上下文-协议服务器，它允许您通过 AI 查询和管理您的 Azure 和 Microsoft 365 租户。

<img src="https://github.com/merill/lokka/blob/main/assets/lokka-demo-1.gif?raw=true" alt="Lokka 演示 - 用户创建演示" width="500"/>

请参阅 Lokka.dev 了解如何将 Lokka 与您喜欢的 AI 模型和聊天客户端一起使用。

Lokka 让您可以使用 Claude Desktop 或任何 MCP 客户端，通过自然语言在 Microsoft API 中完成 Azure 和 Microsoft 365 租户中的任务。

例如：

• 创建一个新的名为 'Sales and HR' 的安全组，并基于部门属性设置动态规则。
• 查找所有未排除紧急访问帐户的条件访问策略。
• 显示分配给 'Call center' 组的所有 Intune 设备配置策略。
• 上个月 Azure 中最昂贵的服务是什么？

入门

请参阅文档以获取有关如何安装和配置 Lokka 的更多信息。

• 介绍
• 安装指南
• 开发者指南

组件

工具

1. Lokka-Microsoft
   • 调用 Microsoft Graph & Azure API。支持查询 Azure 和 Microsoft 365 租户。如果提供了权限，也支持更新。
   • 输入：
     • apiType (字符串): 要查询的 Microsoft API 类型。选项：'graph' 表示 Microsoft Graph (Entra)，或 'azure' 表示 Azure 资源管理。
     • path (字符串): 要调用的 Azure 或 Graph API URL 路径（例如 '/users', '/groups', '/subscriptions'）。
     • method (字符串): 使用的 HTTP 方法（例如 get, post, put, patch, delete）。
     • apiVersion (字符串): Azure 资源管理 API 版本（对于 apiType 为 Azure 时必需）。
     • subscriptionId (字符串): Azure 订阅 ID（针对 Azure 资源管理）。
     • queryParams (字符串): 类似 $filter, $select 等的查询参数数组。所有参数都是字符串。
     • body (JSON): 请求体（适用于 POST, PUT, PATCH）。
   • 返回: 来自 Azure 或 Graph API 调用的结果。

环境变量

服务器的配置是通过环境变量完成的。需要以下环境变量：

安装

要将此服务器与 Claude Desktop 应用一起使用，请将以下配置添加到您的 claude_desktop_config.json 文件的 "mcpServers" 部分：

{
  "mcpServers": {
    "Lokka-Microsoft": {
      "command": "npx",
      "args": ["-y", "@merill/lokka"],
      "env": {
        "TENANT_ID": "<tenant-id>",
        "CLIENT_ID": "<client-id>",
        "CLIENT_SECRET": "<client-secret>"
      }
    }
  }
}

请确保将 <tenant-id>、<client-id> 和 <client-secret> 替换为您的 Microsoft Entra 应用程序中的实际值。（有关如何创建 Entra 应用并配置代理的更多详细信息，请参阅安装指南。）