mcp-tooling-ts

name

mcp-tooling-ts

description

Manage and maintain a TypeScript MCP server using @modelcontextprotocol/sdk with Express and Streamable HTTP/SSE. Supports setup, adding new MCP tools (handler.ts/prompt.ts/type.ts/index.ts), enforcing strict Zod schemas, token-lean prompts (Claude/Grok friendly), manual tool registration, and transport-level API key injection (query/header → env, never in tool params). All code examples use TypeScript (.ts files). Triggers: "setup MCP server", "add MCP tool", "create handler.ts prompt.ts type.ts", "register tool", "refactor MCP prompt", "API key via header/query".

MCP Tooling TS

Purpose

Standardize development of a TypeScript MCP server with:

• Manual tool registration
• Strict Zod schemas
• Token-efficient prompts
• Transport-level API key injection

---

Canonical Project Structure (Minimal)

src/
├─ mcp-node.ts              # Server entry (env injection here only)
├─ registerTools.ts         # Calls registerAllTools(server, env)
├─ tools/index.ts           # Manual registry of all tools
└─ utils/                   # Utility methods and helpers

---

Server Setup (Express + SSE + Streamable HTTP)

mcp-node.ts - Server Entry Point

All transport endpoints (SSE and Streamable HTTP) are implemented directly in mcp-node.ts:

import express from 'express';
import cors from 'cors';
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
import {  }  ;
 {  }  ;
 { registerTools }  ;


 () {
   queryApiKey =  req.. ===  ? req.. : ;
   headerApiKey = req.() ?? req.();
   fusedashApiKey = queryApiKey ?? headerApiKey;

   {
    ...process.,
    ...(fusedashApiKey ? { : fusedashApiKey } : {}),
  };
}


 app = ();
app.(()); 


app.(,  {
  res.().({
    : ,
    : {
      : ,
      : ,
      : 
    },
    :  ().()
  });
});