InditexTech/mcp-teams-server

Microsoft Teams 연동을 위한 MCP (Model Context Protocol) 서버 구현체로, 메시지 읽기, 메시지 생성, 메시지 답장, 멤버 언급 기능을 제공합니다.

MCP-Teams-Server-Showcase.mp4

• 제목과 내용을 포함하여 채널에 스레드(thread)를 시작하고 사용자 언급

• 메시지 답장을 통해 기존 스레드 업데이트 및 사용자 언급

• 스레드 답장 읽기

• 채널 팀 멤버 목록 조회

• 채널 메시지 읽기

• uv 패키지 매니저 (package manager)

• Python 3.10

• 적절히 설정된 Microsoft Teams 계정

• 저장소(repository) 클론:

git clone [repository-url]
cd mcp-teams-server

• 가상 환경(virtual environment) 생성 및 의존성 설치:

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

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

셸(shell) 또는 .env 파일에 다음 환경 변수(environment variables)를 설정하세요. 샘플 파일을 템플릿으로 사용할 수 있습니다:

Key	Description
TEAMS_APP_ID	MS Entra ID 애플리케이션 ID를 위한 UUID
TEAMS_APP_PASSWORD	클라이언트 비밀번호 (Client secret)
TEAMS_APP_TYPE	SingleTenant 또는 MultiTenant
TEAMS_APP_TENANT_ID	SingleTenant인 경우 테넌트(Tenant) UUID
TEAM_ID	MS Teams 그룹 ID 또는 팀 ID
TEAMS_CHANNEL_ID	URL 이스케이프 문자가 포함된 MS Teams 채널 ID

서버 시작:

uv run mcp-teams-server

통합 테스트(Integration tests)를 위해서는 다음 환경 변수를 설정해야 합니다:

Key	Description
TEST_THREAD_ID	스레드 ID의 타임스탬프 (timestamp)
TEST_MESSAGE_ID	메시지 ID의 타임스탬프 (timestamp)
TEST_USER_NAME	테스트 사용자 이름

uv run pytest -m integration

ghcr.io에 호스팅되는 사전 빌드된 이미지(pre-built image)가 있습니다. 다음 명령어를 실행하여 이 이미지를 설치할 수 있습니다.

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 파일의 환경 변수 (environment variables)를 사용하여 실행하려면:

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

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

변경 사항 및 버전 내역은 CHANGELOG.md를 참조하세요.

행동 강령 (code of conduct) 및 풀 리퀘스트 (pull requests) 제출 프로세스에 대한 자세한 내용은 CONTRIBUTING.md를 읽어주세요.

보안 관련 사항은 보안 정책 (Security Policy)을 확인해 주세요.

이 프로젝트는 Apache-2.0 라이선스 하에 배포됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

© 2025 INDUSTRIA DE DISEÑO TEXTIL S.A. (INDITEX S.A.)