merill/lokka

MCP (Model Context Protocol) for Microsoft 365. Includes support for Microsoft Graph and other services

什么是 Lokka？

Lokka 是一个小型服务器，支持 模型-上下文-协议 (MCP)，充当 AI 聊天客户端（例如 Claude Desktop）与 Microsoft 的云 API（Microsoft Graph 和 Azure 资源管理 (RM) API）之间的桥梁。实际上，您可以输入自然语言命令，如 “创建一个名为‘销售与人力资源’的安全组” 或 “上个月最昂贵的 Azure 服务是什么？”，Lokka 会将这些请求转换为相应的 Graph 或 Azure REST 调用，并将结果返回给聊天客户端。

它如何工作？

认证 – Lokka 支持多种获取 Microsoft 访问令牌的方式：
- 交互式登录（用户交互式 OAuth 流程）——最简单的方式，使用默认的 Lokka 应用或您注册的自定义 Entra 应用。
- 应用专用（客户端凭据）认证——使用客户端密钥或 PEM 编码的证书。
- 客户端提供令牌——您通过 set-access-token 工具提供预先获取的 Graph 令牌。
MCP 服务器——您通过 npx @merill/lokka 启动 Lokka（通常在 Claude Desktop 配置的 mcpServers 部分中配置）。服务器监听 stdin/stdout，并遵循 MCP 规范。
工具调用——AI 模型调用 Lokka 的内置工具：
- Lokka‑Microsoft——用于 Graph 或 Azure RM 调用的通用包装器（您指定 apiType、path、HTTP 方法等）。
- set-access-token——在客户端提供令牌模式下更新令牌。
- get-auth-status——报告当前的认证模式以及服务器是否已准备就绪。
Graph 版本控制——默认情况下，Lokka 使用 Graph 的 beta 端点（可访问最新功能）。将 USE_GRAPH_BETA=false 设置为强制所有调用使用稳定的 v1.0 端点。

适合谁？

希望通过对话式 AI 自动化 Azure 或 Microsoft 365 管理的 IT 管理员。
构建需要与 Microsoft 云服务交互但不想编写原始 HTTP 代码的自定义 AI 助手的 开发者。
偏好自然语言命令而非 Azure 门户或 Graph Explorer 的 Claude Desktop（或任何 MCP 兼容客户端）高级用户。

快速入门（快速步骤）

安装——无需永久安装；运行 npx -y @merill/lokka。

配置认证——在 claude_desktop_config.json 的 mcpServers 下添加一个块：

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

（将 CLIENT_SECRET 替换为证书变量，或设置 USE_INTERACTIVE=true 以使用交互式登录。）

将 Lokka 添加到 Claude Desktop——MCP 客户端将自动发现 Lokka‑Microsoft 工具。
提出问题——在聊天窗口中输入自然语言请求；Claude（或其他模型）将在后台调用 Lokka‑Microsoft 工具并展示结果。

主要特性

多模式认证（交互式、证书、客户端密钥、令牌注入）。
统一工具（Lokka‑Microsoft）——可查询或修改 Graph 和 Azure RM 资源。
Beta/生产 Graph 切换（USE_GRAPH_BETA）。
令牌管理工具（set-access-token、get-auth-status）。
一键式 VS Code 安装——通过徽章链接，支持 Windows/macOS/Linux。

如何了解更多？

文档网站：https://lokka.dev – 完整安装指南、开发者参考和示例提示。
GitHub 仓库：https://github.com/merill/lokka – 星标、问题和贡献指南。
赞助页面：如果您觉得 Lokka 有用，可以在 GitHub Sponsors 上支持作者。

简要总结

Lokka 是一个轻量级的 npm-run 服务器，使 AI 聊天工具能够直接与 Microsoft Graph 和 Azure API 通信。通过处理认证并公开一个简单的 MCP 兼容工具，它将自然语言命令转化为真实的云管理操作，让 Azure 和 Microsoft 365 的管理变得对话式且无需脚本。