MCP Starter Server

A minimal ModelContextProtocol server template for building AI assistant tools. This starter provides a basic structure for creating MCP tools that can be used with AI assistants like Claude.

Features

Simple "hello world" tool example
TypeScript + esbuild setup
Development tools preconfigured

Setup to build and run with Claude

Download and install Claude desktop app from claude.ai/download
Clone the repo, install dependencies and build:

npm install
npm run build

Configure Claude to use this MCP server. If this is your first MCP server, in the root of this project run:

echo '{
  "mcpServers": {
    "mcp-starter": {
      "command": "node",
      "args": ["'$PWD'/dist/index.cjs"]
    }
  }
}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

This should result in an entry in your claude_desktop_config.json like:

"mcpServers": {
  "mcp-starter": {
    "command": "node",
    "args": ["/Users/matt/code/mcp-starter/dist/index.cjs"]
  }
}

If you have existing MCP servers, add the mcp-starter block to your existing config. It's an important detail that the args is the path to <path_to_repo_on_your_machine>/mcp-starter/dist/index.cjs.

Restart Claude Desktop.
Look for the hammer icon with the number of available tools in Claude's interface to confirm the server is running.
If this is all working, you should be able to develop your MCP server using npm run dev and test it in Claude. You'll need to restart Claude each time to restart the MCP server.

Developing with Inspector

For development and debugging purposes, you can use the MCP Inspector tool. The Inspector provides a visual interface for testing and monitoring MCP server interactions.

Visit the Inspector documentation for detailed setup instructions.

To test locally with Inspector:

npm run inspect

To build on file changes run:

npm run watch

Or run both the watcher and inspector:

npm run dev

Publishing

Once you're ready to distribute your server, it's simple!

Set up an NPM account.
Run npm publish. This will publish a package using the project name in package.json
Once published, others can install the server with a config entry like:

"mcpServers": {
  "<your-package-name>": {
    "command": "npx",
    "args": ["<your-package-name>"]
  }
}

Available Tools

The server provides:

hello_tool: A simple example tool that takes a name parameter and returns a greeting

Creating New Tools

To add new tools:

Define the tool schema in index.ts
Add it to the tools array in the ListToolsRequestSchema handler
Add the implementation in the CallToolRequestSchema handler

See the hello_tool implementation as an example.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

hello_tool

This server provides a minimal template for creating AI assistant tools using the ModelContextProtocol, featuring a simple 'hello world' tool example and development setups for building custom MCP tools.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP-SERVER-TEMPLATE
vyasa1986
-
security
F
license
-
quality
A TypeScript-based starter template for building Model Context Protocol servers that enables AI assistants to dynamically call tools, interpret prompts, and manage resources through modular architecture with support for multiple transport methods.
Last updated -
TypeScript
MCP Template
rhit-bhuwalk
-
security
A
license
-
quality
A template for building Model Context Protocol servers that allow AI assistants to interact with custom data and services through queryable resources and specialized tools.
Last updated -
TypeScript
MIT License
MCP Demo Server
joeguo911
A
security
F
license
A
quality
A demonstration server based on Model Context Protocol (MCP) that showcases how to build custom tools for AI assistants, providing mathematical calculation and multilingual greeting capabilities.
Last updated -
3
TypeScript
MCP Server Boilerplate
CaptainCrouton89
-
security
F
license
-
quality
A starter template for building Model Context Protocol servers that can integrate AI assistants with custom tools, resource providers, and prompt templates.
Last updated -
JavaScript

View all related MCP servers

MCP Starter Server