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

Integrations