Policy MCP Server

Introduction

The Policy MCP Server is a Model Context Protocol (MCP) compliant Azure Functions application that exposes policy management capabilities as standardized MCP tools. This server enables AI models and clients to discover, list, and retrieve policy details through the MCP protocol.

Key Features

• MCP Protocol Compliance - Fully implements MCP 2024-11-05 specification
• Policy Management - Manage and query policies with full metadata
• Tool Discovery - Clients can discover available tools and their schemas
• Error Handling - Robust error handling with JSON-RPC error codes
• Container-Ready - Docker support for easy deployment
• Azure Functions - Hosted on Azure Functions runtime for scalability

Getting Started

Prerequisites

• .NET 10.0 SDK - Download
• Azure Functions Core Tools - npm install -g azure-functions-core-tools@4
• Docker (optional) - For containerized deployment
• Postman (optional) - For testing API endpoints

Installation

1. Clone the repository

   git clone <repository-url>
   cd ai-mcp-container-app
   

2. Navigate to the project

   cd source/PolicyMcpServer
   

3. Install dependencies

   dotnet restore
   

Software Dependencies

• Microsoft.Azure.Functions.Worker v2.51.0
• Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore v2.1.0
• Microsoft.Azure.Functions.Worker.ApplicationInsights v2.50.0
• .NET 10.0 runtime

Build and Run

Local Development

Build the project:

cd source/PolicyMcpServer
dotnet build

Run the server locally:

func start

The server will start at: http://localhost:7071

Docker

Build Docker image:

docker build -t policy-mcp-server:latest .

Run in Docker:

docker run -p 8080:80 policy-mcp-server:latest

Access at: http://localhost:8080

Testing

Quick Start with Postman

1. Import the collection:

   • Open Postman
   • Click Import → Select Test/PolicyMCP-Postman-Collection.json

2. Set the base URL variable:

   • Go to Collections tab → Policy MCP Server
   • Edit base_url variable (default: http://localhost:7071)

3. Run the requests in order:

   • MCP Initialize
   • List Available Tools
   • List All Policies
   • Get Policy Details
   • Error Handling Test

Discovering the Server - Get Manifest

Clients can discover the server's capabilities by fetching the manifest first:

curl -X GET http://localhost:7071/api/mcp/manifest \
  -H "Content-Type: application/json"

Expected Response:

{
  "mcpVersion": "2024-11-05",
  "name": "PolicyMcpServer",
  "version": "1.0.0",
  "description": "Policy Management Model Context Protocol Server",
  "author": "Your Organization",
  "license": "MIT",
  "tools": [
    {
      "name": "listPolicies",
      "description": "Returns a list of all policies with basic metadata.",
      "inputSchema": { "type": "object", "properties": {} }
    },
    {
      "name": "getPolicyDetails",
      "description": "Returns full metadata for a single policy by ID.",
      "inputSchema": {
        "type": "object",
        "properties": { "policyId": { "type": "string" } },
        "required": ["policyId"]
      }
    }
  ],
  "endpoints": {
    "initialize": "/api/mcp/initialize",
    "invoke": "/api/mcp/invoke",
    "tools": "/api/mcp/tools",
    "manifest": "/api/mcp/manifest"
  }
}

The manifest provides:

• Server information - Name, version, and description
• Tool definitions - All available tools with input schemas
• Endpoint information - Routes to all MCP endpoints

Clients use this manifest to discover what tools are available before calling the initialize endpoint.

Manual Testing with cURL

1. Initialize MCP Connection

curl -X POST http://localhost:7071/api/mcp/i

... [View full README on GitHub](https://github.com/ravindersirohi/McpServer-In-Docker#readme)