Stateless Hono MCP Server

@mhart

About Stateless Hono MCP Server

An example Hono MCP server using Streamable HTTP

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-hono-stateless": {
      "command": "node",
      "args": [
        "node_modules/@modelcontextprotocol/sdk/dist/esm/examples/client/simpleStreamableHttp.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Stateless Hono MCP Server?

Stateless Hono MCP Server is an example MCP server built on Hono, using Streamable HTTP transport. It is designed for deployment to Cloudflare Workers and other platforms that support Hono, and serves as a reference for implementing stateless MCP servers.

How to use Stateless Hono MCP Server?

Run npm start to start the server locally on port 3000, then connect using an MCP client like the one at node node_modules/@modelcontextprotocol/sdk/dist/esm/examples/client/simpleStreamableHttp.js with the command connect http://localhost:3000/mcp. Deploy to Cloudflare Workers using npm run deploy.

Key features of Stateless Hono MCP Server

Streamable HTTP transport for MCP
Deployable to Cloudflare Workers
Start-notification-stream tool included
Greeting-template prompt included
Stateless server example
Based on official MCP Express example

Use cases of Stateless Hono MCP Server

Testing MCP client connections with a simple server
Demonstrating stateless MCP server deployment on edge platforms
Experimenting with Streamable HTTP transport
Learning how to build MCP servers with Hono
Deploying a lightweight MCP endpoint on Cloudflare Workers

FAQ from Stateless Hono MCP Server

What runtime does this server require?

It requires Node.js for local development and can be deployed to Cloudflare Workers.

What tools and prompts are available?

The server provides one tool (start-notification-stream) and one prompt (greeting-template).

How do I test the server locally?

Run npm start, then use the example MCP client to connect to http://localhost:3000/mcp and issue commands like list-tools or list-prompts.

How do I deploy the server?

Run npm run deploy to deploy to Cloudflare Workers. The server can also run anywhere Hono is supported.

Is the server stateful or stateless?

It is stateless, as indicated by its name and use of Streamable HTTP transport.

Frequently asked questions

What runtime does this server require?

It requires Node.js for local development and can be deployed to Cloudflare Workers.

What tools and prompts are available?

The server provides one tool (`start-notification-stream`) and one prompt (`greeting-template`).

How do I test the server locally?

Run `npm start`, then use the example MCP client to connect to `http://localhost:3000/mcp` and issue commands like `list-tools` or `list-prompts`.

How do I deploy the server?

Run `npm run deploy` to deploy to Cloudflare Workers. The server can also run anywhere Hono is supported.

Is the server stateful or stateless?

It is stateless, as indicated by its name and use of Streamable HTTP transport.

Comments

Basic information

More Other MCP servers

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K