Example Remote Server

MCP Feature Reference Server

This repository provides a complete MCP server implementation that

• demonstrates all MCP protocol features (tools, resources, prompts, sampling)
• implements OAuth 2.0 authentication using the recommended separate auth server architectural pattern
• serves as a learning resource and starting template for building your own MCP servers

The [Model Context Protocol](https://modelcontextprotocol.io) enables seamless integration between AI applications and external data sources, tools, and services.

Table of Contents

• Quick Start
• MCP Features
• Development Setup
• Project Structure
• Documentation
• Contributing
• License

Quick Start

To start exploring ASAP:

# Clone and install
git clone https://github.com/modelcontextprotocol/example-remote-server.git
cd example-remote-server
npm install

# Start the server with in-process auth and in-memory session management
npm run dev:internal

# In another terminal, run MCP Inspector
npx -y @modelcontextprotocol/inspector

# Inspector will open a browser window.
# Connect to http://localhost:3232/mcp to authenticate and explore server features

The server is now running a lightweight config with everything bundled in a single process:

• authentication is handled by an in-process module, rather than a separate server
• sessions are stored in memory, rather than in Redis

Other configurations are available: see [Development Setup](#development-setup), below.

MCP Features

This server implements the complete MCP specification:

• Tools: 7 example tools including echo, add, long-running operations, and LLM sampling
• Resources: 100+ example resour