Mcp Server Basic Sample

What is Mcp Server Basic Sample?

A minimal TypeScript-based MCP (Model Context Protocol) server sample intended to demonstrate how to build, test, and configure a custom MCP server with desktop clients like Claude for Desktop. It is a starting point for developers learning to create MCP servers.

How to use Mcp Server Basic Sample?

Install dependencies with pnpm install, then build with pnpm build. Run the MCP Inspector for testing via pnpm start or pnpm inspect. To use with Claude for Desktop, add a server entry named RandomNumber in the Claude desktop config file (claude_desktop_config.json) pointing to the built build/index.js and the correct Node.js binary.

Key features of Mcp Server Basic Sample

• Minimal TypeScript MCP server for learning and prototyping
• Supports running and testing via the MCP Inspector
• Configurable with Claude for Desktop as a local server
• Includes a ready-to-use RandomNumber server name in example config

Use cases of Mcp Server Basic Sample

• Learning how to structure and build an MCP server from scratch
• Testing MCP server functionality locally with the Inspector tool
• Demonstrating integration of a custom MCP server with Claude for Desktop
• Experimenting with the MCP protocol without external dependencies

FAQ from Mcp Server Basic Sample

How do I install and build the server?

Run pnpm install to install dependencies, then pnpm build to compile the TypeScript code.

How can I test the server with the MCP Inspector?

Use the commands pnpm start or pnpm inspect to launch the Inspector. Refer to the official Inspector documentation for further guidance.

How do I configure Claude for Desktop to use this server?

Edit the file ~/Library/Application Support/Claude/claude_desktop_config.json. Add an entry under mcpServers with the key RandomNumber, the command node (or the full Node path from mise which node), and the absolute path to build/index.js.

Does the server require any runtime beyond Node.js?

Yes, it requires Node.js (tested with version 22.14.0 in the example). The README shows how to use mise to manage Node versions.

What predefined tools or resources does this server provide?

The README does not describe any tools, resources, or prompts beyond naming the server entry as RandomNumber in the config example. No explicit capabilities are listed.