Microsoft 365 MCP 서버

💡 설명

현재 이 작업은 진행 중이며, 해결책이라기보다는 POC(실증 연구)에 가깝습니다. 목표는 Microsoft 365 명령에 대한 모든 종류의 CLI를 실행할 수 있는 MCP 서버를 만드는 것입니다.

📦 필수 조건

Node.js 20.x 이상

🚀 빌드 및 실행 방법

무엇보다도 먼저 npm install 실행하여 모든 종속성을 설치하세요.

그런 다음 프로젝트를 빌드하려면 다음을 실행합니다.

지엑스피1

이 도구를 테스트하려면 이 MCP 서버가 앱으로 Microsoft 365에 대해 인증할 수 있도록 Entra 앱 요청과 인증서를 만들어야 합니다. 필요한 범위가 있는 인증서와 앱 요청을 만들고 인증서와 함께 테넌트에 추가하려면 createApp.ps1 스크립트를 실행하고 지침을 따르세요. 비밀번호를 제외한 대부분의 항목은 인증서를 만들 때 비워 둘 수 있습니다. 비밀번호가 필요합니다. 스크립트는 Microsoft 365용 CLI를 사용하여 앱 요청 및 기타 항목을 생성하므로 먼저 npm i -g @pnp/cli-microsoft365 사용하여 Microsoft 365용 CLI를 전역적으로 설치하고 테넌트에 관리자로 로그인해야 합니다. 스크립트를 실행한 후 필요한 범위와 인증서가 있는 Entra ID에 'MCP 서버 테스트' 앱 등록 정보가 표시되어야 합니다. 또한 temp 폴더에 인증서 파일과 내보낸 base64 인코딩 인증서가 표시되어야 합니다. 나중에 필요합니다.

검사기를 사용하여 MCP 실행

M365 MCP 서버를 테스트하는 방법 중 하나는 MCP Inspector를 사용하는 것입니다. 먼저 다음 명령을 사용하여 M365 MCP 서버를 시작하세요.

npm run start

이제 MCP 서버에 대한 검사기를 실행하고 필요한 매개변수를 환경으로 전달하여 MCP 서버가 이를 수집하고 Microsoft 365에 대해 인증하는 데 사용할 수 있도록 하려면 다음 명령을 실행할 수 있습니다.

npx @modelcontextprotocol/inspector -e CertificatePassword='YOUR_PASSOWRD' -e AppId='ENTRA_APP_REG_ID' -e TenantId='TENANT_ID' -e TenantUrl='TENANT_URL' -e CertificateBase64Encoded='BASE64_ENCODED_VALUE_OF_YOUR_CERT' node dist/index.js

그 후 검사기가 시작될 때까지 기다렸다가 브라우저에서 검사기를 열어 보세요. MCP 서버가 실행 중인 것을 확인할 수 있으며, 도구를 쿼리하고 로컬에서 실행할 수 있습니다.

VS Code에서 MCP 실행

로컬 빌드에서 VS Code의 MCP 서버를 실행하여 GitHub Copilot Agent에서 사용할 수도 있습니다. 현재 이 기능은 VS Code Insiders에서만 지원됩니다. 먼저 다음 명령을 사용하여 M365 MCP 서버를 시작하세요.

npm run start

이제 VS Code GitHub Copilot Agent 모드로 이동하여 도구 아이콘을 클릭하고 Add more tools 선택하세요. 그런 다음 Add MCP server 선택하고 Command (stdio) 선택한 후 다음 명령을 입력하세요.

node FULL_PATH_TO_YOUR_PROJECT/dist/index.js

Enter 키를 누르고 원하는 이름을 입력하세요. 테스트를 위해 workspace 범위에 추가하는 것이 좋습니다. 그런 다음 .vscode/mcp.json 파일을 열고 인증에 필요한 환경 변수를 전달하도록 수정하세요.

{
    "servers": {
        "m365-mcp-server": {
            "type": "stdio",
            "command": "node",
            "args": [
                "FULL_PATH_TO_YOUR_PROJECT/dist/index.js" // e.g. C:/workspace/repo/microsoft-365-mcp-server/dist/index.js
            ],
            "env": {
                "CertificateBase64Encoded": "BASE64_ENCODED_VALUE_OF_YOUR_CERT",
                "CertificatePassword": "YOUR_PASSOWRD",
                "AppId": "ENTRA_APP_REG_ID",
                "TenantId": "TENANT_ID",
                "TenantUrl": "TENANT_URL" // e.g. https://tenanttocheck.sharepoint.com/
            }
        }
    }
}

시작을 클릭하면 GitHub Copilot Agent에 4개의 새 도구가 추가된 것을 확인할 수 있습니다. 직접 테스트해 보세요.

🎬 데모

👉 영화 🎬

Microsoft 365 MCP Server