Skip to main content
Glama
yigitkonur

example-mcp-server-streamable-http-stateless

by yigitkonur

example-mcp-stateless

learning-first MCP boilerplate for HTTP stateless servers using TypeScript SDK v2 pre-release.

part of a series: stdio · stateless (you are here) · stateful · sse

what it does

  • runs a stateless MCP server where every request gets a fresh McpServer instance -- no sessions, no state, no coordination

  • registers example tools (calculate, describe_stateless_limits), resources (boilerplate://limitations, boilerplate://topic/{topic}), and a prompt (design-next-tool)

  • includes a scaffold CLI to bootstrap new projects and generate tool/resource/prompt stubs

  • vendors SDK v2 pre-release tarballs for reproducible builds

  • ships with Docker support, CI workflow, and a smoke test

Related MCP server: OpenAPI MCP Server

quick start

git clone https://github.com/yigitkonur/example-mcp-stateless.git cd example-mcp-stateless npm install npm run dev

the server starts at http://127.0.0.1:1071/mcp. verify with:

curl http://127.0.0.1:1071/health

Docker alternative:

docker-compose up -d

scaffold cli

build the CLI first, then scaffold a new project:

npm run build npm run cli -- init my-mcp-server --install

generate stubs inside an existing project:

npm run create -- generate tool my_tool npm run create -- generate resource my_resource npm run create -- generate prompt my_prompt

full reference: docs/03-scaffold-cli.md

documentation

document

description

docs/01-getting-started.md

install, run, configure, verify

docs/02-architecture.md

module layout, stateless pattern, endpoint contract

docs/03-scaffold-cli.md

init and generate command reference

docs/04-sdk-v2-notes.md

v2 packages, vendoring, migration from v1

docs/05-validation.md

CI breakdown, smoke test, mcp-cli verification

sdk v2 context

this repo tracks MCP TypeScript SDK v2 in pre-release form. it uses the split package model (@modelcontextprotocol/server, @modelcontextprotocol/node, @modelcontextprotocol/express) and the registerTool/registerResource/registerPrompt APIs with Zod v4 schemas. tarballs are vendored in vendor/mcp-sdk-v2/ for reproducibility.

license

MIT

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yigitkonur/example-mcp-server-streamable-http-stateless'

If you have feedback or need assistance with the MCP directory API, please join our Discord server