MCP 팀 서버

Microsoft Teams 통합을 위한 MCP( 모델 컨텍스트 프로토콜 ) 서버 구현으로, 메시지 읽기, 메시지 작성, 메시지에 답장, 멤버 언급 등의 기능을 제공합니다.

특징

https://github.com/user-attachments/assets/548a9768-1119-4a2d-bd5c-6b41069fc522

제목과 내용으로 채널에서 스레드를 시작하고 사용자를 언급합니다.
기존 스레드를 메시지 답글로 업데이트하고 사용자를 언급합니다.
스레드 답글 읽기
채널 팀원 목록
채널 메시지 읽기

필수 조건

uv 패키지 관리자
파이썬 3.10
적절한 설정이 적용된 Microsoft Teams 계정

설치

저장소를 복제합니다.

지엑스피1

가상 환경을 만들고 종속성을 설치합니다.

uv venv
uv sync --frozen --all-extras --dev

팀 구성

Microsoft Teams 및 필요한 Azure 리소스를 구성하는 데 도움이 되는 이 문서를 읽어보세요. 단계별 가이드는 아니지만 필요한 사항을 파악하는 데 도움이 될 수 있습니다.

용법

셸이나 .env 파일에서 다음 환경 변수를 설정하세요. 샘플 파일을 템플릿으로 사용할 수 있습니다.

열쇠	설명
팀 앱 ID	MS Entra ID 애플리케이션 ID에 대한 UUID
팀 앱 비밀번호	클라이언트 비밀번호
팀 앱 유형	SingleTenant 또는 MultiTenant
팀 앱 테넌트 ID	SingleTenant의 경우 테넌트 UUID
팀 ID	MS Teams 그룹 ID 또는 팀 ID
팀 채널 ID	URL 이스케이프 문자가 포함된 MS Teams 채널 ID

서버를 시작합니다:

uv run mcp-teams-server

개발

통합 테스트를 위해서는 다음과 같은 환경 변수를 설정해야 합니다.

열쇠	설명
테스트_스레드_ID	스레드 ID의 타임스탬프
테스트_메시지_ID	메시지 ID의 타임스탬프
테스트_사용자_이름	테스트 사용자 이름

uv run pytest -m integration

미리 빌드된 도커 이미지

ghcr.io에 미리 빌드된 이미지 가 호스팅되어 있습니다. 다음 명령을 실행하여 이 이미지를 설치할 수 있습니다.

docker pull ghcr.io/inditextech/mcp-teams-server:latest

도커 이미지 빌드

MCP 서버를 실행하기 위한 Docker 이미지가 있습니다. 다음 명령어로 빌드할 수 있습니다.

docker build . -t inditextech/mcp-teams-server

도커 이미지 실행

기본 실행 구성:

docker run -it inditextech/mcp-teams-server

.env 파일에서 환경 변수로 실행:

docker run --env-file .env -it inditextech/mcp-teams-server

MCP Teams 서버를 사용하도록 LLM 설정

다음 문서 의 지침을 따르세요.

변경 사항

변경 사항 및 버전 기록 목록은 CHANGELOG.md를 참조하세요.

기여하다

행동 강령과 풀 리퀘스트 제출 프로세스에 대한 자세한 내용은 CONTRIBUTING.md를 읽어보세요.

보안

보안 문제에 대해서는 보안 정책을 참조하세요.

특허

이 프로젝트는 Apache-2.0 파일에 따라 라이선스가 부여되었습니다. 자세한 내용은 여기에서 확인하세요.

MCP Microsoft Teams Server

Integrations