This sample demonstrates how to expose your Semantic Kernel instance or a Agent as an MCP (Model Context Protocol) server.
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.pyor:
uv --directory=<path to sk project>/semantic-kernel/python/samples/demos/mcp_server run agent_mcp_server.pyTo 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 8000or:
uv --directory=<path to sk project>/semantic-kernel/python/samples/demos/mcp_server run agent_mcp_server.py --transport sse --port 8000This will start a server that listens for incoming requests on port 8000.
In both cases, uv will ensure that semantic-kernel is installed with the mcp extra in a temporary virtual environment.
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.