Microsoft 365 MCP 서버용 CLI

💡 설명

현재 이 작업은 진행 중이며 해결책이라기보다는 POC에 가깝습니다.

Related MCP server: Microsoft MCP

📦 필수 조건

• Node.js 20.x 이상

🚀 빌드 및 실행 방법

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

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

지엑스피1

이 MCP 서버는 npm i -g @pnp/cli-microsoft365 사용하여 전역적으로 설치해야 하는 Microsoft 365용 글로벌 설치 CLI를 사용합니다.

MCP 서버는 사용자를 대신하여 인증을 수행하지 않습니다. 먼저 Microsoft 365 CLI에서 m365 login 명령을 사용하여 인증해야 합니다. 인증이 완료되면 MCP 서버는 모든 도구를 실행할 때 동일한 인증 컨텍스트를 사용합니다.

검사기를 사용하여 MCP 실행

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

npm run start

이제 MCP 서버의 검사기를 실행하려면 repo 루트 폴더 위치에서 다음 명령을 실행해야 합니다.

npx @modelcontextprotocol/inspector node dist/index.js

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

VS Code에서 MCP 실행

로컬 빌드에서 VS Code로 MCP 서버를 실행하여 GitHub Copilot Agent에서 사용할 수도 있습니다. 먼저 다음 명령을 사용하여 Microsoft 365 MCP 서버 CLI를 시작하세요.

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
            ]
        }
    }
}

시작을 클릭하면 GitHub Copilot Agent에 358개의 새로운 도구가 추가된 것을 확인할 수 있습니다. 직접 테스트해 보세요. 최상의 결과를 얻으려면 AI 모델로 Claude 3.5 Sonnet 사용하는 것이 좋습니다.

🔗 리소스

• 타입스크립트-SDK

• MCP 서버

• MCP 검사관

• VS Code에서 MCP 서버 사용(미리 보기)

• Microsoft 365용 CLI를 프로그래밍 방식으로 사용