chenreuven_mcp_ts_simple_template
by ChenReuvenTypeScript MCP Server Template
A lightweight, ready-to-use TypeScript template for building Model Context Protocol (MCP) servers. This template provides the essential scaffolding to create custom AI tools that can be seamlessly integrated with large language models.
Overview
This template implements a basic MCP server with a sample BMI calculator tool. It demonstrates how to:
- Set up an MCP server in TypeScript
- Define and implement MCP tools with input validation using Zod
- Connect the server to standard I/O for communication
Prerequisites
- Node.js (v20 or higher recommended)
- npm or yarn
Installation
- Clone this repository
- Install dependencies:
npm install
Project Structure
index.ts- Main server implementation with sample toolpackage.json- Project dependencies and scriptstsconfig.json- TypeScript configuration
Usage
Building and Running
Build and start the server:
npm start
This will compile the TypeScript code and start the MCP server.
Development
For development, you can:
- Modify
index.tsto add your own tools - Run the build command to compile:
npm run build
Creating Custom Tools
To create a new tool, follow this pattern in index.ts:
server.tool(
"your-tool-name",
{
// Define input schema using Zod
paramName: z.string(),
// Add more parameters as needed
},
async ({ paramName }) => ({
content: [{
type: "text",
text: "Your tool's response"
}]
})
);
Dependencies
@modelcontextprotocol/sdk- Core MCP SDKzod- Schema validationdotenv- Environment variable managementtypescript- TypeScript compiler
License
ISC
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
About
A lightweight, ready-to-use TypeScript template for building Model Context Protocol (MCP) servers. This template provides the essential scaffolding to create custom AI tools that can be seamlessly integrated with large language models.
Resources
Stars
Watchers
Forks
No releases published
No packages published
Invite Gmail Contacts
