typescript-mcp-server

The users MCP server, served over stdio.

Scripts

Related MCP server: HREVN MCP Server

Configuration

Copy .env.example to .env. All variables are declared and validated in src/config.ts; startup fails with a readable message if any are invalid.

Layout

src/
  index.ts               Entry point: serve the users server over stdio
  config.ts              Env vars, loaded and validated once
  logger.ts              pino logger (pretty in development)
  tool-result.ts         Builds the CallToolResult shape
  servers/
    users/
      index.ts           createUsersServer(): registers the tools
      users.api.ts       API calls that return data
      users.schema.ts    zod schemas for input and output

Logging

stdout is the JSON-RPC wire, so never use console.log — import logger from src/logger.ts, which writes to stderr.

Errors

Tool handlers do not need try/catch. The MCP SDK catches anything thrown and returns it as a tool result flagged isError, so an API call can simply throw (as findUser does when there is no match).

Adding a tool

Add the API call to users.api.ts, its schemas to users.schema.ts, and a server.registerTool(...) block in servers/users/index.ts.

Adding another MCP server

Create src/servers/<name>/ with the same three files, exporting a create<Name>Server(): McpServer. Give it its own entry file that calls serveStdio with that factory, since one stdio process serves one server.