Summary
This is a TypeScript template project that demonstrates how to build and deploy custom MCP servers on Smithery using Express and Docker containers. It supports both STDIO and HTTP transports via an environment variable, includes CORS headers for browser clients, and shows how to handle Smithery's session configuration system. The example implements basic character counting functionality, but the real value is as a starting point for your own server. You get request logging middleware, interactive testing through Smithery's playground CLI, and a complete deployment setup with smithery.yaml configuration. Reach for this when you want to build a production MCP server with HTTP support rather than STDIO only, or when you need custom container deployment on Smithery's infrastructure.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
TypeScript MCP Server with Custom Container
A simple TypeScript MCP server built using the official MCP TypeScript SDK, Express, and custom Docker container. This example demonstrates how you can host HTTP servers on Smithery using custom containers, with STDIO support for backwards compatibility.
See the complete guide: https://smithery.ai/docs/migrations/typescript-custom-container
Features:
- CORS: CORS headers for browser-based MCP clients
- Smithery Session Configuration: handles user's session configuration passed via Smithery (learn more)
- Request Logging Middleware: Custom middleware for debugging HTTP requests and responses
- Server Transport: Can run with both STDIO and HTTP transports using
TRANSPORTenv variable
Prerequisites
- Node.js 22 or higher
- npm package manager
Project Structure
src/index.ts- Main Express server with MCP HTTP transportpackage.json- Node.js dependencies and scriptssmithery.yaml- Smithery deployment and session configurationDockerfile- Dockerfile to host server in Smithery
Quick Start
-
Install dependencies:
npm install -
Run the development server:
HTTP Mode:
npm run devThis will start the server on port 8081.
-
Test interactively: Once your server is running in HTTP mode, you can test it interactively using the Smithery playground:
npx -y @smithery/cli playground --port 8081
-
Deploy your own version: To deploy your own MCP server:
- Connect your repository at https://smithery.ai/new
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →