Support unix domain sockets for local transport

[scottslewis]

Description

It would be helpful to have an alternative to stdio-based local-only communication. One reason is that with stdio a client restart pretty much implies/requires a server restart.

I've opened this issue for java sdk: modelcontextprotocol/java-sdk#415 and contributed a pr modelcontextprotocol/java-sdk#439

I would be willing to produce a pr for this feature request if desired. I assume that anyio based blocking (or non-blocking?) would be desired for consistency with existing transport code.

References

No response

[dsp-ant]

We won't provide a unix domain sockets transport in the SDK. The SDK aims to provide the MCP standard, which defines STDIO and Streamable HTTP. Unix Domain Sockets will fit under the umbrella of custom transports, which should be easy enough to provide on top of the SDK, by providing the necessary streams.

[scottslewis]

Forgive me, but that's very short sighted. Stdio is lame as a local transport and I would happily provide an impl/pr if it would be welcomed rather than just defined as out of scope. Perhaps be a little more open to community contributions? This is supposed to be an open project, no?

…

On Wed, Aug 13, 2025, 8:44 AM David Soria Parra ***@***.***> wrote: *dsp-ant* left a comment (modelcontextprotocol/python-sdk#1266) <#1266 (comment)> We won't provide a unix domain sockets transport in the SDK. The SDK aims to provide the MCP standard, which defines STDIO and Streamable HTTP. Unix Domain Sockets will fit under the umbrella of custom transports, which should be easy enough to provide on top of the SDK, by providing the necessary streams. — Reply to this email directly, view it on GitHub <#1266 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AABHB5BBPSSADSS3CENQU5L3NNMNLAVCNFSM6AAAAACDXX4P4OVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTCOBUGQ2TAOJQHA> . You are receiving this because you authored the thread.Message ID: ***@***.***>