MCP Server Basic Sample

🚀 Basic Example of MCP Server

This project provides a basic example of an MCP server, guiding you through the preparation, configuration, and usage of the server.

🚀 Quick Start

📦 Installation

First, install the necessary packages:

pnpm install

🔨 Build

Then, build the project:

pnpm build

✨ Features

MCP Inspection Tool

You can use the MCP inspection tool to check the server status.

• Inspector - Model Context Protocol

Start the server:

pnpm start

Run the inspection:

pnpm inspect

Claude for Desktop

💾 Download Claude for Desktop

Download Claude for Desktop from the following link: Download - Claude

⚙️ Configure Claude for Desktop

Open the configuration file in VSCode:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

The path is: /Users/[User]/Library/Application Support/Claude/claude_desktop_config.json

The configuration content is as follows:

{
  "mcpServers": {
    "RandomNumber": {
      "command": "node",
      "args": ["/Absolute path to the parent folder/build/index.js"]
    }
  }
}

If you are using mise, you can find the path of the node command:

$ mise which node
/Users/[User]/.local/share/mise/installs/node/22.14.0/bin/node

The corresponding configuration is:

{
  "mcpServers": {
    "RandomNumber": {
      "command": "/Users/[User]/.local/share/mise/installs/node/22.14.0/bin/node",
      "args": ["/Absolute path to the parent folder/build/index.js"]
    }
  }
}

Reference: https://github.com/modelcontextprotocol/servers/issues/64#issuecomment-2503152420

📚 Documentation

Resources

• Example Servers - Model Context Protocol
• Official TypeScript SDK for Model Context Protocol Server and Client
• Guide to Implementing an MCP Server in TypeScript and Using it on Claude Desktop
• How to Simply Implement a Custom MCP Server