Metadata-Version: 2.4
Name: azure-updates-mcp
Version: 0.2.0
Summary: MCP server for Azure Updates JSON API
Project-URL: Homepage, https://github.com/jonnybottles/azure-updates-mcp
Project-URL: Repository, https://github.com/jonnybottles/azure-updates-mcp
Project-URL: Issues, https://github.com/jonnybottles/azure-updates-mcp/issues
Author: azure-updates-mcp contributors
License: MIT
License-File: LICENSE
Keywords: api,azure,mcp,model-context-protocol,updates
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: fastmcp<3,>=2.14
Requires-Dist: httpx>=0.28
Requires-Dist: pydantic>=2.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Description-Content-Type: text/markdown

# Azure Updates MCP Server

mcp-name: io.github.jonnybottles/azure-updates

A Python-based MCP (Model Context Protocol) server that provides tools for querying and searching the Azure Updates RSS feed.

## Requirements

### General

- **Python 3.9+**
- An MCP-compatible client (Claude Desktop, Cursor, Claude Code, GitHub Copilot CLI, etc.)

### Using `uvx` (Recommended)

If you are installing or running the server via **`uvx`**, you must have **uv** installed first.

- **uv** (includes `uvx`): https://github.com/astral-sh/uv

Install uv:

```bash
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
irm https://astral.sh/uv/install.ps1 | iex
```

Verify installation:

```bash
uv --version
uvx --version
```

> `uvx` allows you to run the MCP server without installing the package globally.

### Using pip (Alternative)

If you prefer not to use `uvx`, you can install the package directly with pip.

```bash
pip install azure-updates-mcp
```

In this case, `uv` / `uvx` is **not required**.

### Optional (for development)

- `git`
- `pytest`
- `ruff`

---

## Quick Install

[![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0078d4?style=flat-square&logo=visualstudiocode)](https://vscode.dev/redirect/mcp/install?name=azure-updates-mcp&config=%7B%22type%22%3A%20%22stdio%22%2C%20%22command%22%3A%20%22uvx%22%2C%20%22args%22%3A%20%5B%22azure-updates-mcp%22%5D%7D)
[![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-000000?style=flat-square&logo=cursor)](https://cursor.com/docs/context/mcp)
[![Install in Claude Code](https://img.shields.io/badge/Install_in-Claude_Code-9b6bff?style=flat-square&logo=anthropic)](https://code.claude.com/docs/en/mcp)
[![Install in Copilot CLI](https://img.shields.io/badge/Install_in-Copilot_CLI-28a745?style=flat-square&logo=github)](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/use-copilot-cli)

> **One-click install:** Click VS Code badge for automatic setup (requires `uv` installed)
> **Manual install:** See instructions below for Cursor, Claude Code, Copilot CLI, or Claude Desktop

## Features

- **azure_updates_search** – Search and filter Azure updates by keyword, category, status, date range, or GUID
- **azure_updates_summarize** – Get statistical overview and trends of Azure updates
- **azure_updates_list_categories** – List all available Azure service categories

## Prompt Examples

Once connected to an MCP client, you can ask questions like:

1. **Get recent updates**: "Show me the 10 most recent Azure updates"
2. **Search by keyword**: "Find all Azure updates related to Kubernetes or AKS"
3. **Filter by status**: "What Azure features are currently in preview?"
4. **Check for retirements**: "Are there any upcoming Azure service retirements I should know about?"
5. **Get overview**: "Give me a summary of Azure update activity over the last 2 weeks"

## Installation

### Install from PyPI

```bash
uvx azure-updates-mcp
```

Or install with pip:

```bash
pip install azure-updates-mcp
```

### Install from source (for development)

```bash
git clone https://github.com/YOUR-USERNAME/azure-updates-mcp.git
cd azure-updates-mcp
pip install -e ".[dev]"
```

## Usage

### Run the MCP Server

```bash
uvx azure-updates-mcp
```

Or if installed with pip:

```bash
azure-updates-mcp
```

### Connect from Claude Desktop

Add to your Claude Desktop MCP config:

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

**Using uvx (recommended)**

```json
{
  "mcpServers": {
    "azure-updates": {
      "command": "uvx",
      "args": ["azure-updates-mcp"]
    }
  }
}
```

**Using installed package**

```json
{
  "mcpServers": {
    "azure-updates": {
      "command": "azure-updates-mcp"
    }
  }
}
```

### Connect from Cursor

**Option 1: One-Click Install (Recommended)**

```
cursor://anysphere.cursor-deeplink/mcp/install?name=azure-updates-mcp&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyJhenVyZS11cGRhdGVzLW1jcCJdfQ==
```

**Option 2: Manual Configuration**

Add to your Cursor MCP config:

- macOS: `~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
- Windows: `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`

### Connect from Claude Code

```bash
claude mcp add --transport stdio azure-updates -- uvx azure-updates-mcp
```

### Connect from GitHub Copilot CLI

Add to `~/.copilot/mcp-config.json`:

```json
{
  "mcpServers": {
    "azure-updates": {
      "type": "stdio",
      "command": "uvx",
      "args": ["azure-updates-mcp"]
    }
  }
}
```

## Development

```bash
pytest
ruff check src/ tests/
```

## License

MIT
