microsoft--semantic-kernel/python/samples/demos/mcp_server/README.md

Semantic Kernel as MCP Server

This sample demonstrates how to expose your Semantic Kernel instance or a Agent as an MCP (Model Context Protocol) server.

Getting Started with Stdio

To run these samples using the stdio transport (default), set up your MCP host (like Claude Desktop or VSCode GitHub Copilot Agents) with the following configuration:

{
    "mcpServers": {
        "sk": {
            "command": "uv",
            "args": [
                "--directory=<path to sk project>/semantic-kernel/python/samples/demos/mcp_server",
                "run",
                "sk_mcp_server.py"
            ],
            "env": {
                "OPENAI_API_KEY": "<your_openai_api_key>",
                "OPENAI_CHAT_MODEL_ID": "gpt-4o-mini"
            }
        },
        "agent": {
            "command": "uv",
            "args": [
                "--directory=<path to sk project>/semantic-kernel/python/samples/demos/mcp_server",
                "run",
                "agent_mcp_server.py"
            ],
            "env": {
                "AZURE_AI_AGENT_PROJECT_CONNECTION_STRING": "<your azure connection string>",
                "AZURE_AI_AGENT_MODEL_DEPLOYMENT_NAME": "<your azure model deployment name>",
            }
        }
    }
}

Alternatively, you can run the server directly with the following command:

uv --directory=<path to sk project>/semantic-kernel/python/samples/demos/mcp_server run sk_mcp_server.py

or:

uv --directory=<path to sk project>/semantic-kernel/python/samples/demos/mcp_server run agent_mcp_server.py

Getting Started with SSE

To run these samples as an SSE (Server-Sent Events) server, set the same environment variables as above and run the following command:

uv --directory=<path to sk project>/semantic-kernel/python/samples/demos/mcp_server run sk_mcp_server.py --transport sse --port 8000

or:

uv --directory=<path to sk project>/semantic-kernel/python/samples/demos/mcp_server run agent_mcp_server.py --transport sse --port 8000

This will start a server that listens for incoming requests on port 8000.

Note

By default the SSE server binds to 127.0.0.1 (loopback) and only accepts requests with a loopback Host header and, when present, a loopback Origin header. A local MCP server exposes tools, plugins and model providers backed by your own credentials, so it is good practice to keep it reachable only from your own machine. The MCP specification recommends validating Origin and binding to loopback, in part to guard against DNS rebinding.

You can override the bind address with --host, e.g. --host 0.0.0.0 to expose the server on the network. Do this only on a trusted network. The bundled Host/Origin checks only allow loopback callers, so a non-loopback deployment needs proper authentication - see the mcp_with_oauth sample for the authenticated, Streamable-HTTP pattern recommended for production.

---

In both cases, uv will ensure that semantic-kernel is installed with the mcp extra in a temporary virtual environment.

Extending the sample

The sk_mcp_server sample creates two functions:

• echo-echo_function: A simple function that echoes back the input.
• prompt-prompt: a function that uses a Semantic Kernel prompt to generate a response.

The agent_mcp_server sample creates a simple agent that uses the Azure OpenAI service to generate a response. It exposes a single function:

• mcp-host: A function that uses the Azure OpenAI service to generate a response.

Once the server is created, you get a mcp.server.lowlevel.Server object, which you can then extend to add further functionality, like resources or prompts.