Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Server TypeScript Template add 15 and 27"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A template for creating Model Context Protocol (MCP) servers using TypeScript. This project demonstrates how to implement a simple MCP server with custom tools.
This template implements a basic MCP server that provides tools for:
Example operation: A simple demonstration operation
Addition: A tool that adds two numbers
The server uses the Model Context Protocol SDK to handle communication between AI models and external tools.
Related MCP server: MCP Server Starter
Node.js (v16 or higher)
npm or yarn
The project is structured as follows:
mcp-server-typescript-template/
├── common/
│ ├── constant.ts # Project constants
│ ├── errors.ts # Error handling utilities
│ └── types.ts # Type definitions
│ └── utils.ts # Utility functions
├── operations/
│ └── example-operation.ts # Implementation of example operations
├── index.ts # Main server implementation
├── package.json
└── tsconfig.jsonClone the repository and install dependencies:
git clone <repository-url>
cd mcp-server-typescript-template
npm install
npm run test
npm run build
npm run start # this will start the server for testingedit your claude_desktop_config.json file to add the following:
{
"mcpServers": {
"example": {
"command": "node",
"args": [
"/path/to/mcp-server-typescript-template/dist/index.js"
]
}
}
}
Add two numbers
Inputs: a (required), b (required).
A simple example operation
Inputs: date (required), email (required), name (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 2 tools
The two tools have clearly distinct purposes: 'addition' performs a mathematical operation on two numbers, while 'example_operation' appears to be a generic demonstration tool. There is no overlap or ambiguity between them, making it easy for an agent to select the correct tool based on the task.
The naming is mixed: 'addition' uses a noun form, while 'example_operation' uses a noun_verb pattern. This inconsistency in verb usage and structure makes the set less predictable, though both names are still readable and descriptive.
With only two tools, this server feels thin and under-scoped for a general-purpose TypeScript template. Such a template typically implies broader utility or demonstration capabilities, making this count insufficient for meaningful agent interactions or coverage of a domain.
The tool surface is severely incomplete for a TypeScript template server, which might be expected to include more operations like file handling, API interactions, or common utilities. The two tools provided do not cover any coherent domain or lifecycle, leaving significant gaps for agent workflows.
Kickstart development with a customizable TypeScript template featuring sample tools for greeting,…
A Model Context Protocol server for Wix AI tools
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A simple Typescript MCP server built using the official MCP Typescript SDK and smithery/cli. This…