Kludex

Local MCP servers over HTTP

Author: Marcelo Trylesinski

TL;DR

MCP has two transports that do not share a design, so every HTTP feature needs a second stdio version and every SDK maintains two pipelines. The roadmap proposes HTTP/2 over stdin/stdout. This document compares that with three alternatives and recommends HTTP/1.1 over a Unix socket on POSIX and a named pipe on Windows: the existing Streamable HTTP code runs unchanged, it is native in most

Kludex

//
// MIT License
// Copyright (c) 2025 Marcelo Trylesinski
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:

Kludex

from mcp.server import FastMCP
import logfire
import uvicorn

logfire.configure()

server = FastMCP("Summarizer")
app = server.sse_app()
logfire.instrument_starlette(app)

Kludex

from fastapi import FastAPI
import httpx
from typer import Typer, Context

app = FastAPI()


@app.get("/")
def read_root():
    return {"Hello": "World"}

Kludex

def a(n: int) -> int:
    records = 0
    for _ in range(n):
        for _ in range(n):
            for _ in range(n):
                records += 1
    return records


def sum_a(n: int) -> int:

Kludex

from pydantic import BaseModel

BaseModel.model_config['protected_namespaces'] = ()

class Potato(BaseModel):
    model_potato: str


class Carrot(BaseModel):
    model_carrot: str

Kludex

from typing import Any, Collection, List, TypeVar, Annotated

from annotated_types import MinLen
from pydantic import BaseModel

_CollectionT = TypeVar("_CollectionT", bound=Collection[Any])

NonEmpty = Annotated[_CollectionT, MinLen(1)]

Kludex

from typing import Type, Callable, Any

from bson.objectid import ObjectId, InvalidId
from pydantic import BaseModel, ValidationError
from pydantic_core import CoreSchema, core_schema


class PydanticObjectId(ObjectId):
    @classmethod
    def __get_pydantic_core_schema__(

Kludex

import importlib
import pkgutil


def get_public_objects(package_name, parent_module=""):
    objects = []
    full_package_name = (
        parent_module + "." + package_name if parent_module else package_name
    )
    package = importlib.import_module(full_package_name)

Kludex

"""Create a virtual environment, and run a different python process."""
import os
import subprocess
import tempfile
import venv

with tempfile.TemporaryDirectory() as temp_dir:
    VENV_PATH = os.path.join(temp_dir, "venv")
    venv.create(VENV_PATH, with_pip=True)
    python_exe = os.path.join(VENV_PATH, "bin", "python")