MCP Teams Server

Model Context Protocol (MCP) server uygulaması, Microsoft Teams entegrasyonu için, mesajları okuma, mesaj oluşturma, mesajlara yanıt verme, üyeleri mention etme yeteneklerini sağlar.

Özellikler

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

• Başlık ve içerik ile kanala thread başlatma, kullanıcıları mention etme
• Mevcut threadleri mesaj yanıtları ile günceleme, kullanıcıları mention etme
• Thread yanıtlarını okuma
• Kanal takım üyelerini listeleme
• Kanal mesajlarını okuma

Ön Koşullar

• uv package manager
• Python 3.10
• Uygun şekilde kurulmuş Microsoft Teams hesabı

Kurulum

1. Repository'yi klonlayın:

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

2. Virtual environment oluşturun ve bağımlılıkları kurun:

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

Teams Konfigürasyonu

Microsoft Teams'i ve gerekli Azure kaynaklarını yapılandırmaya yardımcı olması için bu belgeyi okuyun. Bu adım adım bir kılavuz değildir ancak ihtiyacınız olacakları anlamanıza yardımcı olabilir.

Kullanım

Aşağıdaki ortam değişkenlerini shell'inizde veya .env dosyasında ayarlayın. Örnek dosyayı şablon olarak kullanabilirsiniz:

Anahtar	Açıklama
TEAMS_APP_ID	MS Entra ID uygulama ID'si için UUID
TEAMS_APP_PASSWORD	Client secret
TEAMS_APP_TYPE	SingleTenant veya MultiTenant
TEAMS_APP_TENANT_ID	SingleTenant durumunda tenant uuid
TEAM_ID	MS Teams Group Id veya Team Id
TEAMS_CHANNEL_ID	MS Teams Channel ID (url encoded)

Server'ı başlatın:

uv run mcp-teams-server

Geliştirme

Integration testleri aşağıdaki ortam değişkenlerinin ayarlanmasını gerektirir:

Anahtar	Açıklama
TEST_THREAD_ID	Thread id'nin timestamp'i
TEST_MESSAGE_ID	Mesaj id'nin timestamp'i
TEST_USER_NAME	Test kullanıcı adı

uv run pytest -m integration

Önceden oluşturulmuş docker image

ghcr.io'da barındırılan önceden oluşturulmuş bir image mevcuttur. Bu image'i aşağıdaki komutla kurabilirsiniz:

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

Docker image oluşturma

MCP server'ı çalıştırmak için bir docker image mevcuttur. Aşağıdaki komutla oluşturabilirsiniz:

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

Docker image çalıştırma

Temel çalıştırma konfigürasyonu:

docker run -it inditextech/mcp-teams-server

.env dosyasından ortam değişkenleri ile çalıştırma:

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

LLM'yi MCP Teams Server kullanacak şekilde yapılandırma

Aşağıdaki belgedeki talimatları izleyin

Değişiklik Günlüğü

Değişiklikler ve sürüm geçmişi için CHANGELOG.md sayfasına bakın.

Katkıda Bulunma

Davranış kurallarımız ve pull request gönderme süreci hakkında ayrıntılar için CONTRIBUTING.md sayfasını okuyun.

Güvenlik

Güvenlik endişeleri için lütfen Güvenlik Politikamıza bakın.

Lisans

Bu proje Apache-2.0 altında lisanslanmıştır. Ayrıntılar için dosyaya bakın.

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