SharePoint MCP 서버

Microsoft SharePoint와의 원활한 통합을 지원하는 경량 MCP 서버로, MCP 클라이언트가 문서, 폴더 및 기타 SharePoint 리소스와 상호 작용할 수 있도록 지원합니다. sofias tech 에서 개발했습니다.

특징

이 서버는 문서 관리를 위한 최적화된 작업과 함께 모델 컨텍스트 프로토콜(MCP)을 통해 SharePoint 리소스에 대한 깔끔한 인터페이스를 제공합니다.

도구

서버는 다음 도구를 구현합니다.

• List_SharePoint_Folders : 지정된 디렉토리 또는 루트에 있는 모든 폴더를 나열합니다.

• List_SharePoint_Documents : 지정된 폴더 내의 모든 문서를 가져옵니다.

• Get_Document_Content : 문서의 내용을 검색합니다(텍스트 또는 base64로 인코딩된 바이너리).

• Create_Folder : 지정된 디렉토리 또는 루트에 새 폴더를 만듭니다.

• Upload_Document : 지정된 폴더에 새 문서를 업로드합니다.

• Upload_Document : 경로에서 대용량 문서를 업로드합니다.

• Update_Document : 기존 문서의 내용을 업데이트합니다.

• Delete_Document : 지정된 폴더에서 문서를 제거합니다.

• Delete_Folder : SharePoint에서 빈 폴더를 삭제합니다.

Related MCP server: MCP Server

건축학

서버는 리소스 효율성을 염두에 두고 구축되었습니다.

• 선택적 속성 로딩을 통한 효율적인 SharePoint API 사용

• 더 깔끔한 코드를 위한 데코레이터를 통한 오류 처리

• 리소스 관리와 도구 구현 간의 명확한 분리

• 텍스트 및 바이너리 파일 모두에 대한 최적화된 콘텐츠 처리

설정

1. 적절한 SharePoint 권한으로 Azure AD에 앱 등록

2. 등록된 앱의 클라이언트 ID와 클라이언트 비밀번호를 얻으세요

3. 작업하려는 SharePoint 사이트 URL과 문서 라이브러리 경로를 식별하세요.

환경 변수

서버에는 다음과 같은 환경 변수가 필요합니다.

• SHP_ID_APP : Azure AD 애플리케이션 클라이언트 ID

• SHP_ID_APP_SECRET : Azure AD 애플리케이션 클라이언트 비밀번호

• SHP_SITE_URL : SharePoint 사이트의 URL

• SHP_DOC_LIBRARY : 문서 라이브러리 경로(기본값: "Shared Documents/mcp_server")

• SHP_TENANT_ID : Microsoft 테넌트 ID

빠른 시작

설치

지엑스피1

또는 게시된 후 PyPI에서 설치하세요.

pip install mcp-sharepoint-server

uv를 사용하여:

uv pip install mcp-sharepoint-server

Claude 데스크톱 통합

Claude Desktop과 통합하려면 구성 파일을 업데이트하세요.

Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json macOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json

표준 통합

"mcpServers": {
  "sharepoint": {
    "command": "mcp-sharepoint",
    "env": {
      "SHP_ID_APP": "your-app-id",
      "SHP_ID_APP_SECRET": "your-app-secret",
      "SHP_SITE_URL": "https://your-tenant.sharepoint.com/sites/your-site",
      "SHP_DOC_LIBRARY": "Shared Documents/your-folder",
      "SHP_TENANT_ID": "your-tenant-id"
    }
  }
}

uvx 사용

"mcpServers": {
  "sharepoint": {
    "command": "uvx",
    "args": [
      "mcp-sharepoint"
    ],
    "env": {
      "SHP_ID_APP": "your-app-id",
      "SHP_ID_APP_SECRET": "your-app-secret",
      "SHP_SITE_URL": "https://your-tenant.sharepoint.com/sites/your-site",
      "SHP_DOC_LIBRARY": "Shared Documents/your-folder",
      "SHP_TENANT_ID": "your-tenant-id"
    }
  }
}

개발

요구 사항

• 파이썬 3.10+

• requirements.txt 및 pyproject.toml 에 나열된 종속성

지역 개발

1. 저장소를 복제합니다

2. 가상 환경 만들기:

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. 개발 종속성 설치:

   pip install -e .

4. SharePoint 자격 증명을 사용하여 .env 파일을 만듭니다.

   SHP_ID_APP=your-app-id
   SHP_ID_APP_SECRET=your-app-secret
   SHP_SITE_URL=https://your-tenant.sharepoint.com/sites/your-site
   SHP_DOC_LIBRARY=Shared Documents/your-folder
   SHP_TENANT_ID=your-tenant-id

5. 서버를 실행합니다:

   python -m mcp_sharepoint

디버깅

MCP 서버를 디버깅하려면 MCP Inspector를 사용할 수 있습니다.

npx @modelcontextprotocol/inspector -- python -m mcp_sharepoint

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

Copyright (c) 2025 소피아스테크