Quick Start

Installation

npm install @johannes.latzel/llm-chat-mcp

Requirements: Node.js >= 18, TypeScript >= 5.0 (the package ships .js with type declarations from dist/).

Stdio server (one-liner)

import { StdioMcpServer } from '@johannes.latzel/llm-chat-mcp';

const server = new StdioMcpServer({ name: 'my-server', version: '1.0.0' });
server.register(tool); // Tool or ToolPackage instance
await server.start(); // reads requests on stdin, writes on stdout

HTTP server (Streamable HTTP)

import { HttpMcpServer } from '@johannes.latzel/llm-chat-mcp';

const server = new HttpMcpServer({ name: 'my-server', version: '1.0.0', port: 3000 });
server.register(tool); // Tool or ToolPackage instance
await server.start(); // binds to http://localhost:3000

The /mcp endpoint follows the Streamable HTTP transport spec. Each HTTP client gets its own session with an isolated transport + McpServer pair.

Client example

# Initialize
curl -X POST http://localhost:3000/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0"}}}'

# List tools (use Mcp-Session-Id from the initialize response)
curl -X POST http://localhost:3000/mcp \
  -H 'Content-Type: application/json' \
  -H 'Mcp-Session-Id: <session-id>' \
  -H 'Mcp-Protocol-Version: 2025-03-26' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

# Disconnect
curl -X DELETE http://localhost:3000/mcp \
  -H 'Mcp-Session-Id: <session-id>'

Graceful shutdown

await server.stop();

Closes all active HTTP sessions / stdio transport before returning.

Next steps

See the Architecture for design details and the API Reference for the full API surface.