Template

Provides a ready-to-use MCP server template with TypeScript tooling to expose custom tools for Cursor or Claude Desktop.

typescript

14

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hypermodel-labs-mcp-server-template": {
      "command": "node",
      "args": [
        "ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js"
      ]
    }
  }
}

You will learn how to run and integrate a Model Context Protocol (MCP) server built as a TypeScript template. This server provides a basic MCP structure, a sample tool, and clear steps to connect with MCP clients like Cursor or Claude Desktop, enabling you to expose your own tools and logic as MCP endpoints.

How to use

Set up your MCP server so clients can load and execute your tools. You will run your local server and connect it to clients via stdio. The template includes a ready-to-run build of a server script and a sample tool you can customize.

{
  "type": "stdio",
  "name": "template_mcp",
  "command": "node",
  "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js"]
}

To use with Cursor, add a new MCP server entry and point to the compiled script. Then configure the server name and set the Type to stdio with the command and path to your built index.js.

How to install

Prerequisites: you need Node.js and a package manager. You will also need Git if you are cloning the starter template.

# Step 1: Clone the template repository
git clone [your-repo-url] my-mcp-server
cd my-mcp-server

# Step 2: Install dependencies
pnpm install

# Step 3: Build the project
pnpm run build

The final built server script will be available at /build/index.js. You can then run the MCP server via the stdio configuration described above.

Additional content

Using with Cursor
- Go to Cursor Settings -> MCP -> Add new MCP server
- Configure your MCP:
  - Name: choose your own name
  - Type: command
  - Command: node ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js
  
Using with Claude Desktop
- Add the following MCP config to your Claude Desktop configuration:

{ "mcpServers": { "template_mcp": { "command": "node", "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js"] } } }

" ,

Development notes

The template includes a sample tool implementation in index.ts. To create your own MCP, modify the server configuration to name your MCP and set the version. Then define your custom tools using the server.tool() method and provide a description, parameter schema, and the async handler that returns the formatted response.

Notes on tools and configuration

Tools you can customize include a sample tool with a parameter description. You can replace the sample name and logic to implement real functionality that returns structured text content to MCP clients.

Available tools

your-tool-name

Your tool description