ui-genai-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ui-genai-mcp
Servidor MCP (Model Context Protocol) corporativo em Python (Starlette/SDK MCP) + Docker, hospedado em Azure Container Apps e consumido por agentes do Microsoft Foundry (Teams / M365 Copilot). Serve de base reutilizável para projetos de IA: autenticação Entra por endpoint, OBO para Microsoft Graph e uma arquitetura de toolsets em fatias verticais. O toolset inicial é o diagnostico.
Usuário (Teams/Copilot) ─► Agente Foundry ──Bearer (aud=api://app)──► ui-genai-mcp (/mcp)
▲ card de consentimento (1ª vez) │ valida JWT Entra
└──────────── Entra ID ◄─────────────────────────────────────────┤ OBO (mesmo usuário)
▼
Microsoft Graph / SharePointStatus: Fase 0 — spike de autenticação com o toolset diagnostico (diag_whoami, diag_sharepoint_probe). Ver docs/phase0-spike.md.
Pré-requisitos
uv (
winget install astral-sh.uv). Em rede com inspeção TLS:UV_SYSTEM_CERTS=1.Python 3.13 (o uv instala:
uv python install 3.13).Azure CLI para deploy (
az acr builddispensa Docker local).
Related MCP server: Microsoft Teams MCP Server
Início rápido (local, sem autenticação)
cp .env.example .env # AUTH_ENABLED=false
uv sync
uv run uvicorn ui_genai_mcp.app:app_factory --factory --reload --port 8000
curl http://127.0.0.1:8000/healthz
uv run python scripts/smoke_mcp.py --url http://127.0.0.1:8000/mcp --tool diag_whoamiOu com Docker: docker compose up --build.
Qualidade
uv run pytest # testes (unit, integração HTTP, contrato)
uv run ruff check src tests scripts
uv run ruff format --check src tests scripts
uv run mypy src
UPDATE_CONTRACTS=1 uv run pytest tests/contract # após mudar tools de propósitoConfiguração
Todas as variáveis estão documentadas em .env.example. Principais:
Variável | Descrição |
|
|
| App registration existente (OBO). |
| Scope curto exposto pelo app ( |
| URL pública (define o recurso e o Protected Resource Metadata). |
| Host(s) aceitos — FQDN do Container App (proteção DNS rebinding). |
| Toolsets expostos, separados por vírgula. |
Endpoints
Rota | Uso |
| Transporte MCP Streamable HTTP (stateless, exige Bearer). |
| Protected Resource Metadata (RFC 9728). |
| Liveness / readiness. |
Documentação
docs/adding-a-toolset.md— processo de registro de novas tools.docs/foundry-setup.md— Container Apps, app registration e connection no Foundry.docs/phase0-spike.md— roteiro e critérios do spike.
Troubleshooting
Sintoma | Causa provável |
| FQDN ausente em |
|
|
| Token sem o scope |
| Lifespan do app não executado (subir via |
Mensagem "faça login novamente" | OBO falhou ( |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Permissioned access to Outlook, OneDrive and Teams via the user's own Microsoft account
OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation.
MCP-first toolbox for agents: KV storage, auth, queue, and utility tools. Free in early access.
Connect AI agents to 1000+ apps with managed authentication and tool-calling.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables AI agents to manage SharePoint Online resources including lists, libraries, columns, views, and files through the SharePoint REST API. It supports comprehensive data operations, schema management, and file transfers using secure MSAL authentication.21-
- AlicenseAqualityDmaintenanceEnables AI agents to interact with Microsoft Teams through Microsoft Graph API, using delegated device-code authentication to act on behalf of the user.1637 npmMIT
- AlicenseBqualityBmaintenanceEnables an AI agent to discover and call bounded Microsoft 365 tools for reading calendar, mail, Teams channels, SharePoint, and Power Platform metadata through MCP, with synthetic fixtures by default and optional Microsoft Entra/Graph tenant integration.8MIT
- AlicenseCqualityBmaintenanceConnects LLMs and AI agents to enterprise Microsoft 365 environments, enabling administration across Exchange Online, Microsoft Graph, Entra ID, compliance, security, mailbox operations, and mail-flow diagnostics through 34 tools.34MIT