StdioMCPClient

May 15, 2026 · View on GitHub


该类在类层级结构中的位置:

[Oxy](../agent/base_oxy.md)
├── [BaseFlow](../agent/base_flow.md)
├── [BaseLLM](../llms/base_llm.md)
└── [BaseTool](../tools/base_tools.md)
    ├── [MCPTool](../tools/mcp_tool.md)
    ├── [BaseMCPClient](../tools/base_mcp_client.md)
    │   ├── [StdioMCPClient](../tools/stdio_mcp_client.md)
    │   ├── [SSEMCPClient](../tools/sse_mcp_client.md)
    │   └── [StreamableMCPClient](../tools/streamable_mcp_client.md)
    ├── [HttpTool](../api_tools/http_tool.md)
    ├── [FunctionHub](../function_tools/function_hub.md)
    ├── [FunctionTool](../function_tools/function_tool.md)
    └── [BaseBank](../bank_tools/base_bank.md)
        ├── [BankTool](../bank_tools/bank_tool.md)
        └── [BankClient](../bank_tools/bank_client.md)

简介

StdioMCPClient 是通过标准输入/输出流与 MCP 服务器通信的 MCP 客户端实现。它会启动并管理作为 MCP 服务器的外部进程(如 Node.js 脚本或 Python uvx 包)。

参数

参数类型 / 允许值默认值描述
paramsdict[str, Any]{}配置参数,包括 commandargsenv 值。

方法

方法协程(异步)返回值用途简述
init(is_fetch_tools)None初始化到 MCP 服务器进程的 Stdio 连接。
_ensure_directories_exist(args)None在启动 MCP 服务器前确保所需目录存在。
call_tool(tool_name, arguments, headers)Any打开新的 Stdio 连接并调用指定工具。
get_server_params()StdioServerParameters解析并返回 Stdio 传输的服务器参数。

继承

请参阅 BaseMCPClient 类了解继承的参数和方法。

用法

oxy.StdioMCPClient(
    name="time_tools",
    params={
        "command": "uvx",
        "args": ["mcp-server-time", "--local-timezone=Asia/Shanghai"],
    },
)