代理作为MCP服务器（Microsoft代理框架）
此repo演示了如何 将代理暴露为MCP服务器 使用 微软代理框架（MAF），以及如何从以下位置连接到它：
- 一 测试ping客户端 (
mcp-ping.py)，以及 - 一 ChatAgent编排客户端 (
client-local-mcp.py)它使用本地MCP服务器作为工具。
它使用 STDIO传输 对于MCP，这意味着客户端将服务器作为子进程启动，双方通过以下方式交换JSON-RPC消息 stdin/stdout.
文件 -agent-as-mcp-svr.py--MCP 服务器 通过以下方式暴露代理agent.as_mcp_server()和stdio_server(). -mcp-ping.py--最小 客户端 启动服务器stdio_client()，列出工具，并调用代理工具。 -client-local-mcp.py— 聊天代理 编排示例使用MCPStdioTool连接到本地服务器。
______________________________________________________________________
先决条件
- Python 3.10+
- 推荐：虚拟环境
- 包装：
pip install --pre agent-framework mcp anyio azure-identity python-dotenv环境配置
如果你使用 Azure OpenAI （推荐）：
export AZURE_OPENAI_ENDPOINT="https://.cognitiveservices.azure.com/"
export AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME="gpt-4o" # responses / agent usage
export AZURE_OPENAI_CHAT_DEPLOYMENT_NAME="gpt-4o" # optional for chat client
export AZURE_OPENAI_API_VERSION="2025-03-01-preview" # or 'preview'
# One of:
export AZURE_OPENAI_API_KEY="" # simplest
# OR AAD-based:
# (unset REQUESTS_CA_BUNDLE SSL_CERT_FILE; az login)
# export AZURE_USE_CLI=1企业CA捆绑用户：确保REQUESTS_CA_BUNDLE（以及可选SSL_CERT_FILE)指向a 有效的 PEM路径。对于az login，您可能需要暂时取消设置这些变量。
如何跑步
1） 快速本地ping（STDIO客户端/服务器）
这将服务器作为子进程启动，并调用代理工具：
python mcp-ping.py预期产出（节略）：
TOOLS: ['RestaurantAgent']
== RestaurantAgent input schema ==
{ ... JSON schema ... }
== Health Check (JSON) ==
{ "status": "ok", "endpoint": "...", ... }2） 使用MCP服务器编排ChatAgent
这允许ChatAgent使用本地MCP服务器作为工具：
python client-local-mcp.py它将运行一系列提示（健康检查、菜单列表、饮食过滤器、定价、欢乐时光）。
故障排除
- JSON/EOF无效 当单独运行服务器时，您在没有客户端的情况下启动了服务器。使用
mcp-ping.py（他们启动服务器并使用MCP）。 - 令牌/凭证错误 --提供
AZURE_OPENAI_API_KEY或AZURE_USE_CLI=1随着az login对于AAD链，DefaultAzureCredential必须能够找到身份。 - 工具参数不匹配 --代理作为工具通常需要一个
task弦。确保客户端发送{"task":"your prompt"}.
工作原理（STDIO）
- 服务器:
stdio_server()公开异步stdin/stdout流；server.run()处理JSON-RPC（初始化/list_tools/call_tool）。 - 客户端:
stdio_client()启动服务器进程并返回流；ClientSession驱动JSON-RPC调用。
______________________________________________________________________