`ClientConfig` has inconsistent naming: `message_handler` should be `message_callback`

Initial Checks

• I confirm that I'm using the latest version of MCP Python SDK
• I confirm that I searched for my issue in https://github.com/modelcontextprotocol/python-sdk/issues before opening this issue

Description

ClientConfig exposes five user-facing callback fields, but four of them use the *_callback suffix while one uses *_handler:

# src/mcp/client/client.py
sampling_callback: SamplingFnT | None = None
list_roots_callback: ListRootsFnT | None = None
logging_callback: LoggingFnT | None = None
elicitation_callback: ElicitationFnT | None = None
message_handler: MessageHandlerFnT | None = None  # ← inconsistent

The same inconsistency is present in ClientSession.__init__ and ServerConnectionParams:

# src/mcp/client/session.py
def __init__(self, ..., message_handler: MessageHandlerFnT | None = None, ...)

# src/mcp/client/session_group.py
class ServerConnectionParams:
    message_handler: MessageHandlerFnT | None = None

A TODO comment in the codebase already flags this:

# TODO(Marcelo): Why do we have both "callback" and "handler"?
message_handler: MessageHandlerFnT | None = None

Proposed Fix

Rename message_handler → message_callback consistently across all three sites:

Since this is the v2 rewrite on main, a breaking rename is appropriate and there is no need for a deprecation shim.

I'd like to take this on if you're open to a fix.

Python & MCP Python SDK

Python 3.13
Reproduced on: main @ 161834d (2026-05-13)

Bắt đầu với các định nghĩa callback và các lệnh gọi chuyển tiếp trong src/mcp/client/client.py, sau đó theo dõi tham số liên quan và thuộc tính nội bộ trong src/mcp/client/session.py. Kiểm tra ServerConnectionParams trong src/mcp/client/session_group.py, cùng với biến cục bộ và đối số từ khóa trong src/mcp/client/main.py. Được xem là hoàn tất khi cả bốn vị trí đều nhất quán sử dụng message_callback và không còn cách đặt tên message_handler nào trong luồng này.