SharePoint MCP Server

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에서 빈 폴더를 삭제합니다.

건축학

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

• 선택적 속성 로딩을 통한 효율적인 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에서 설치하세요.

uv를 사용하여:

Claude 데스크톱 통합

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

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

표준 통합

uvx 사용

개발

요구 사항

• 파이썬 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를 사용할 수 있습니다.

특허

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

Copyright (c) 2025 소피아스테크