Snippy is an Azure Functions-based reference application that demonstrates how to build MCP (Model Context Protocol) tools that integrate with AI assistants like GitHub Copilot. It showcases a modern serverless AI application architecture where Azure Functions serve as both traditional APIs and MCP-compatible tools that AI assistants can discover and use.
The system uses Durable Task Scheduler to orchestrate multi-agent workflows, Cosmos DB with vector indexing for semantic code search, and Azure OpenAI for embeddings and LLM capabilities. The project ships with reproducible azd infrastructure—azd up deploys the entire stack and works with both local Docker-based emulators and Azure cloud services.
Important Security Notice This repository is intended for learning and demonstration purposes. Do not deploy it to production without a thorough security review. At a minimum you should:
- Swap connection strings for Managed Identity + Azure Key Vault
- Restrict network access to Azure services via Private Endpoints or service‑tags
- Enable GitHub secret‑scanning and CI security tools
Features • Lab Tutorial • Getting Started • Guidance
Features
- MCP Tool Integration – expose Azure Functions as discoverable MCP tools for AI assistants
- Durable Agents with Microsoft Agent Framework – build stateful AI agents using
ChatAgentwith automatic conversation history management - Multi-Agent Orchestration – coordinate specialized agents (DeepWiki, CodeStyle) using Durable Task Scheduler with fan-out/fan-in patterns
- Vector Search on Cosmos DB DiskANN – semantic code retrieval using Azure OpenAI embeddings and low-latency vector indexing
- Monitoring & Observability – track orchestrations in real-time using DTS dashboard (localhost:8082 local, Azure portal for cloud)
- One-click Deploy –
azd upprovisions and deploys complete infrastructure including Functions, Cosmos DB, Azure OpenAI, and DTS - Codespaces & Dev Containers – fully configured development environment in your browser or local VS Code
Tool Matrix
| Tool Name | Purpose |
|---|---|
save_snippet | Save code snippets with vector embeddings for semantic search |
get_snippet | Retrieve previously saved code snippets by their unique name |
code_style | Generate language-specific code style guides from saved snippets |
deep_wiki | Create comprehensive wiki documentation by analyzing code snippets |
generate_comprehensive_documentation | Orchestrate multi-agent workflow to produce deep wiki and style guide |
Lab Tutorial
New to Snippy? Start with our comprehensive hands-on lab tutorial that guides you through building the entire application from scratch:
📚 Snippy Tutorial: Building an AI-Enhanced Code Snippet Manager
The tutorial covers:
- Step-by-step implementation – Build the complete application with detailed explanations
- Code review exercises – Understand MCP tools, durable agents, and vector search patterns
- Local development – Set up and test with Docker-based emulators
- Azure deployment – Provision and deploy to production with azd
- Multi-agent orchestration – Monitor complex workflows with DTS dashboard
- End-to-end testing – Test with REST Client, GitHub Copilot, and MCP tools
Additional Resources:
- Quick Reference – Essential commands and common tasks
- Troubleshooting Guide – Solutions to common issues
Whether you're new to Azure Functions, MCP tools, or AI agent development, the lab provides a structured learning path with hands-on experience.
Getting Started
Prerequisites
- Azure subscription with permissions to create resources
- azd CLI installed
- Choose your development environment:
- GitHub Codespaces (fastest, no local setup required)
- VS Code Dev Containers (requires Docker Desktop)
- Local development (requires Python 3.11, Node 18+, Azure Functions Core Tools v4)
Deploy to Azure
Using GitHub Codespaces:
Click the "Open in GitHub Codespaces" badge above, then run:
azd auth login --use-device-code
azd up
Using Dev Containers or Local Environment:
azd init --template Azure-Samples/snippy
azd auth login
azd up
The azd up command will:
- Prompt for an Azure region (recommend eastus or swedencentral)
- Provision all resources (Functions, Cosmos DB, Azure OpenAI, DTS)
- Create an Azure AD app registration for authentication
- Deploy the application code
When complete, the Function App URL and MCP endpoint will be displayed. See the tutorial for detailed instructions on local development, testing with emulators, and monitoring orchestrations.
Guidance
Region Availability
Azure OpenAI model support varies by region. Verify availability here and choose the same region for all Azure resources. eastus and swedencentral are good default choices.
Security
Snippy uses User-Assigned Managed Identity for secure service-to-service authentication. The infrastructure is configured with:
- User-Assigned Managed Identity on the Function App with appropriate RBAC roles:
- Cosmos DB Data Contributor
- Storage Blob Data Owner and Queue Data Contributor
- Application Insights Monitoring Metrics Publisher
- Azure AI Project Developer
For production deployments, we recommend:
- Restrict inbound traffic with Private Endpoints + VNet integration
- Enable network security features like service endpoints and firewall rules
Contributing
Standard fork → branch → PR workflow. Use Conventional Commits (feat:, fix:) in commit messages.
License
MIT © Microsoft Corporation