merill/lokka

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

What is Lokka?

Lokka는 모델-컨텍스트-프로토콜 (MCP) 을 지원하는 작고 간단한 서버로, AI 챗 클라이언트(예: Claude Desktop)와 Microsoft의 클라우드 API인 Microsoft Graph 및 Azure Resource Management(RM) API 사이를 연결하는 다리 역할을 합니다. 실제로 "Sales and HR"라는 이름의 보안 그룹을 생성해줘" 또는 "지난 달 가장 비싼 Azure 서비스는 무엇이었나요?" 와 같은 자연어 명령을 입력하면, Lokka는 해당 요청을 적절한 Graph 또는 Azure REST 호출로 변환하여 결과를 챗 클라이언트에 반환합니다.

How does it work?

인증 – 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 엔드포인트로 강제됩니다.

Who is it for?

자연어 기반 AI를 통해 Azure 또는 Microsoft 365 관리를 자동화하고 싶은 IT 관리자.
원시 HTTP 코드를 작성하지 않고도 Microsoft 클라우드 서비스와 상호작용해야 하는 개발자.
Claude Desktop(또는 기타 MCP 호환 클라이언트)의 파워 유저로, Azure 포털이나 Graph Explorer보다 자연어 명령을 선호하는 사람.

Getting started (quick steps)

설치 – 영구 설치 필요 없음; 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>"
      }
    }
  }
}

(클라이언트 시크릿 대신 인증서 변수를 사용하거나, 인터랙티브 로그인을 위해 USE_INTERACTIVE=true를 설정하세요.)

Claude Desktop에 Lokka 추가 – MCP 클라이언트가 자동으로 Lokka‑Microsoft 도구를 탐지합니다.
질문하기 – 챗 창에서 자연어 요청을 입력하면, Claude(또는 다른 모델)가 백그라운드에서 Lokka‑Microsoft 도구를 호출하고 결과를 표시합니다.

Key features

다중 인증 모드 (인터랙티브, 인증서, 클라이언트 시크릿, 토큰 주입).
통합 도구 (Lokka‑Microsoft) – Graph와 Azure RM 리소스를 모두 조회하거나 수정할 수 있습니다.
Beta/프로덕션 Graph 전환 (USE_GRAPH_BETA).
토큰 관리 유틸리티 (set-access-token, get-auth-status).
ワン클릭 VS Code 설치 – Windows/macOS/Linux용 배지 링크를 통해 간편 설치 가능.

Where to learn more?

문서 사이트: https://lokka.dev – 완전한 설치 가이드, 개발자 참조, 예제 프롬프트 포함.
GitHub 리포지토리: https://github.com/merill/lokka – 스타, 이슈, 기여 가이드라인.
스폰서 페이지: Lokka가 유용하다고 느끼신다면 GitHub Sponsors에서 저자를 지원해 주세요.

TL;DR

Lokka는 가벼운 npm-run 서버로, AI 챗 도구가 Microsoft Graph와 Azure API에 직접 접속할 수 있도록 합니다. 인증을 처리하고 간단한 MCP 호환 도구를 노출함으로써 자연어 명령을 실제 클라우드 관리 작업으로 변환하며, Azure와 Microsoft 365 관리를 대화형이고 스크립트 없이 가능하게 만듭니다.