Simple MCP Server

A minimal TypeScript MCP server built with fastMCP that returns “hello” responses.

Features

• Simple MCP server implementation using fastMCP
• TypeScript support
• Biome for formatting and linting
• pnpm as package manager

Getting Started

Prerequisites

• Node.js 18+
• pnpm

Installation

pnpm install

Development

# Build the project
pnpm build

# Run the development server with fastMCP CLI
pnpm mcp:dev

# Use the MCP Inspector with a web UI
pnpm mcp:inspect

# Format code
pnpm format

# Lint code
pnpm lint

Project Structure

• src/server.ts - The main MCP server implementation
• biome.json - Biome configuration for linting and formatting
• tsconfig.json - TypeScript configuration

About the Server

This is a simple MCP (Model Context Protocol) server that provides a “hello” tool. It uses the fastMCP TypeScript framework to simplify server implementation.

Known Issues

• Client Capabilities Warning: When running the server with pnpm mcp:dev or directly, you might see a warning like [warning] FastMCP could not infer client capabilities. This is normal and happens when the client doesn’t provide capabilities information. The server will still function correctly.

How to Use with Claude Desktop

To use this MCP server with Claude Desktop, add the following configuration:

{
  "mcpServers": {
    "Simple Hello Server": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

License

ISC