Skip to content

client

client

MCP Client — connects to MCP servers and discovers/calls tools.

Classes

MCPClient 

MCPClient(transport: MCPTransport)

Client that communicates with an MCP server via a transport.

PARAMETER DESCRIPTION
transport

The transport layer to use for communication.

TYPE: MCPTransport

Source code in src/openjarvis/mcp/client.py 
22
23
24
25
26
def __init__(self, transport: MCPTransport) -> None:
    self._transport = transport
    self._initialized = False
    self._capabilities: Dict[str, Any] = {}
    self._id_counter = itertools.count(1)
Functions
initialize 
initialize() -> Dict[str, Any]

Perform the MCP initialize handshake.

Returns the server capabilities.

Source code in src/openjarvis/mcp/client.py 
47
48
49
50
51
52
53
54
55
def initialize(self) -> Dict[str, Any]:
    """Perform the MCP initialize handshake.

    Returns the server capabilities.
    """
    response = self._send("initialize")
    self._initialized = True
    self._capabilities = response.result.get("capabilities", {})
    return response.result
list_tools 
list_tools() -> List[ToolSpec]

Discover available tools from the server.

Returns a list of ToolSpec objects.

Source code in src/openjarvis/mcp/client.py 
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
def list_tools(self) -> List[ToolSpec]:
    """Discover available tools from the server.

    Returns a list of ``ToolSpec`` objects.
    """
    response = self._send("tools/list")
    tools = response.result.get("tools", [])
    return [
        ToolSpec(
            name=t["name"],
            description=t.get("description", ""),
            parameters=t.get("inputSchema", {}),
        )
        for t in tools
    ]
call_tool 
call_tool(name: str, arguments: Dict[str, Any] | None = None) -> Dict[str, Any]

Call a tool on the server.

Returns the result dictionary with content and isError fields.

Source code in src/openjarvis/mcp/client.py 
73
74
75
76
77
78
79
80
81
82
83
84
def call_tool(
    self, name: str, arguments: Dict[str, Any] | None = None,
) -> Dict[str, Any]:
    """Call a tool on the server.

    Returns the result dictionary with ``content`` and ``isError`` fields.
    """
    response = self._send(
        "tools/call",
        {"name": name, "arguments": arguments or {}},
    )
    return response.result
close 
close() -> None

Close the transport connection.

Source code in src/openjarvis/mcp/client.py 
86
87
88
def close(self) -> None:
    """Close the transport connection."""
    self._transport.close()