Servidor de equipos MCP

Una implementación de servidor MCP ( Protocolo de contexto de modelo ) para la integración de Microsoft Teams , que proporciona capacidades para leer mensajes, crear mensajes, responder mensajes y mencionar miembros.

Características

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

Iniciar hilo en el canal con título y contenido, mencionando a los usuarios.
Actualizar los hilos existentes con respuestas a los mensajes, mencionando a los usuarios
Leer las respuestas del hilo
Enumerar a los miembros del equipo del canal
Leer los mensajes del canal

Prerrequisitos

administrador de paquetes uv
Python 3.10
Cuenta de Microsoft Teams con configuración adecuada

Instalación

Clonar el repositorio:

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

Cree un entorno virtual e instale dependencias:

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

Configuración de equipos

Lea este documento para configurar Microsoft Teams y los recursos de Azure necesarios. No es una guía paso a paso, pero puede ayudarle a determinar qué necesita.

Uso

Configure las siguientes variables de entorno en su shell o en un archivo .env. Puede usar el archivo de ejemplo como plantilla:

Llave	Descripción
ID DE LA APLICACIÓN TEAMS	UUID para el ID de su aplicación MS Entra ID
CONTRASEÑA DE LA APLICACIÓN TEAMS	Secreto del cliente
TIPO DE APLICACIÓN DE EQUIPOS	Inquilino único o multiinquilino
ID DE INQUILINO DE LA APLICACIÓN TEAMS	UUID del inquilino en caso de SingleTenant
ID DE EQUIPO	ID de grupo o ID de equipo de MS Teams
ID DE CANAL DE EQUIPOS	ID de canal de MS Teams con caracteres de escape de URL

Iniciar el servidor:

uv run mcp-teams-server

Desarrollo

Las pruebas de integración requieren la configuración de las siguientes variables de entorno:

Llave	Descripción
ID_DEL_HILO_DE_PRUEBA	marca de tiempo del id del hilo
ID DEL MENSAJE DE PRUEBA	marca de tiempo del identificador del mensaje
NOMBRE_DE_USUARIO_DE_PRUEBA	nombre de usuario de prueba

uv run pytest -m integration

Imagen de Docker preconstruida

Hay una imagen prediseñada alojada en ghcr.io. Puedes instalarla ejecutando el siguiente comando.

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

Construir imagen de Docker

Hay una imagen de Docker disponible para ejecutar el servidor MCP. Puedes compilarla con el siguiente comando:

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

Ejecutar imagen de Docker

Configuración básica de ejecución:

docker run -it inditextech/mcp-teams-server

Ejecutar con variables de entorno desde el archivo .env:

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

Configurar LLM para usar MCP Teams Server

Por favor, siga las instrucciones del siguiente documento

Registro de cambios

Consulte CHANGELOG.md para obtener una lista de cambios y el historial de versiones.

Contribuyendo

Lea CONTRIBUTING.md para obtener detalles sobre nuestro código de conducta y el proceso para enviar solicitudes de extracción.

Seguridad

Por cuestiones de seguridad, consulte nuestra Política de seguridad .

Licencia

Este proyecto está licenciado bajo el archivo Apache-2.0 para más detalles.

MCP Microsoft Teams Server

Integrations