About Azure Terminal Copilot
Azure Terminal Copilot is a Python-based Azure CLI assistant that converts natural language into Azure commands. It runs them through a locally running Azure MCP Server and targets developers who manage Azure resources from the command line. It uses a local Ollama model, which can be swapped for comparison.
Key features
- 01Natural language to Azure command translation
- 02Execution through a local Azure MCP Server
- 03Uses a local Ollama model
- 04Customizable system prompt
Use cases
- 01Querying Azure resource groups with natural language
- 02Comparing model performance on Azure command generation
MCP support
The project acts as an MCP client that connects to a locally running Azure MCP Server to carry out Azure operations.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEAzure Terminal Copilot
A Python-based Azure CLI assistant that provides natural language processing capabilities for Azure commands, leveraging Azure MCP Server.

Prerequisites
- Python 3.11+ (as specified in pyproject.toml)
- Azure CLI installed and configured
- Ollama with a model downloaded
- uv for Python package management
- Azure MCP server installed and running
Installation
-
Clone the repo
git clone https://github.com/yourusername/azure-terminal-copilot.git cd azure-terminal-copilot -
Open the terminal and Start a virtual env with uv
uv venv -
Install packages using uv
uv pip install . -
Run Ollama and make note of its local address
-
Run Azure MCP server and make note of its local address
-
Rename
.env-sampleto.env -
I provided dummy values there so make sure to update with the values that correspond to your locally running ollama, Azure MCP, and model you want to use
-
Now you can run
python main.py
Learning
Once the program is running, try a few things:
- Try providing a query like 'list all my resource groups', is the command you expect to be executed being ran?
- Try different models, notice which ones perform better?
- Try tweaking the system prompt, how would you improve it?
Troubleshooting
- Make sure your azure cli is logged in, azure MCP uses that as auth
License
This project is licensed under the MIT License - see the LICENSE file for details.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.