이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
그래프 API를 통해 Microsoft 365 및 Office 서비스와 상호작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다
개요
그래프 API를 통해 Microsoft 365 및 Microsoft Office 서비스와 상호작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 여러 Microsoft 클라우드 환경을 지원합니다: - Node.js >= 20 (권장) - Node.js 14+ 의존성 경고와 함께 작동할 수 있습니다 - Microsoft 인증 라이브러리(MSAL)를 통한 인증 - 포괄적인 Microsoft 365 서비스 통합 - 안전한 작업을 위한 읽기 전용 모드 지원 - 세분화된 접근 제어를 위한 도구 필터링 서버는 전 세계적으로 구성할 수 있는 두 가지 출력 형식을 지원합니다: 프리티-프린팅이 포함된 표준 JSON 출력: 효율적인 LLM 토큰 사용을 위한 토큰 지향 객체 표기법: - JSON 대비 토큰 수가 30-60% 적음 - 균일한 배열 데이터(이메일, 캘린더 이벤트, 파일 등)에 최적 - 대규모 비용 민감 애플리케이션에 이상
개요(AI 번역)
Microsoft 365 MCP 서버
그래프를 통해 Microsoft 365 및 Microsoft Office 서비스와 상호작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버 API.
지원되는 클라우드
이 서버는 여러 Microsoft 클라우드 환경을 지원합니다:
| 클라우드 | 설명 | 인증 엔드포인트 | 그래프 API 엔드포인트 |
|---|---|---|---|
| 글로벌 (기본값) | 국제 마이크로소프트 365 | login.microsoftonline.com | graph.microsoft.com |
| 중국 (21Vianet) | Microsoft 365는 21Vianet에서 운영됨 | login.chinacloudapi.cn | microsoftgraph.chinacloudapi.cn |
| GCC 고등학교 | Microsoft 365 미국 정부 GCC 고등학교 | login.microsoftonline.us | graph.microsoft.us |
GCC High에는 사전 등록된 클라이언트가 없습니다: 정부 테넌트에 앱을 등록하고 MS365_MCP_CLIENT_ID(그리고 MS365_MCP_TENANT_ID)를 설정한 후 --cloud gcc-high를 사용하세요.
Graph 트래픽을 클라이언트의 일반 HTTP를 종료하고 TLS를 Microsoft로 시작하는 자체 프록시를 통해 라우팅하려면, MS365_MCP_GRAPH_BASE_URL를 기본 URL로 설정하세요; CLI 옵션의 환경 변수 목록을 참고하세요. 이 변수를 우회하는 항목도 포함합니다.
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
ms-365-mcp-server
Microsoft 365 MCP Server
A Model Context Protocol (MCP) server for interacting with Microsoft 365 and Microsoft Office services through the Graph API.
Supported Clouds
This server supports multiple Microsoft cloud environments:
| Cloud | Description | Auth Endpoint | Graph API Endpoint |
|---|---|---|---|
| Global (default) | International Microsoft 365 | login.microsoftonline.com | graph.microsoft.com |
| China (21Vianet) | Microsoft 365 operated by 21Vianet | login.chinacloudapi.cn | microsoftgraph.chinacloudapi.cn |
| GCC High | Microsoft 365 US Government GCC High | login.microsoftonline.us | graph.microsoft.us |
GCC High has no pre-registered client: register an app in your government tenant and set MS365_MCP_CLIENT_ID (and MS365_MCP_TENANT_ID), then use --cloud gcc-high.
To route Graph traffic through a proxy of your own (one that terminates the client’s plain HTTP and originates TLS to Microsoft), set MS365_MCP_GRAPH_BASE_URL to its base URL; see the environment variable list under CLI Options, including what still bypasses it.
Prerequisites
- Node.js >= 20 (recommended)
- Node.js 14+ may work with dependency warnings
Features
- Authentication via Microsoft Authentication Library (MSAL)
- Comprehensive Microsoft 365 service integration
- Read-only mode support for safe operations
- Tool filtering for granular access control
- Tool presets and dynamic discovery to shrink the tool surface and token usage
Output Format: JSON vs TOON
The server supports two output formats that can be configured globally:
JSON Format (Default)
Standard JSON output with pretty-printing:
{
"value": [
{
"id": "1",
"displayName": "Alice Johnson",
"mail": "[email protected]",
"jobTitle": "Software Engineer"
}
]
}
(experimental) TOON Format
Token-Oriented Object Notation for efficient LLM token usage:
value[1]{id,displayName,mail,jobTitle}:
"1",Alice Johnson,[email protected],Software Engineer
Benefits:
- 30-60% fewer tokens vs JSON
- Best for uniform array data (lists of emails, calendar events, files, etc.)
- Ideal for cost-sensitive applications at scale
Usage:
설치
npx -y @softeria/ms-365-mcp-server --toon설정
{
"mcpServers": {
"ms365": {
"command": "npx",
"args": ["-y", "@softeria/ms-365-mcp-server", "--toon"]
}
}
}