https://github.com/matsjfunke/header-test-mcp

MCP Server with tool that returns all headers send to the server
https://github.com/matsjfunke/header-test-mcp

http-headers mcp mcp-server mcp-tools

Last synced: 3 months ago
JSON representation

MCP Server with tool that returns all headers send to the server

• Host: GitHub
• URL: https://github.com/matsjfunke/header-test-mcp
• Owner: matsjfunke
• License: mit
• Created: 2025-09-29T23:13:51.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2025-09-29T23:33:44.000Z (3 months ago)
• Last Synced: 2025-09-30T01:23:25.981Z (3 months ago)
• Topics: http-headers, mcp, mcp-server, mcp-tools
• Language: TypeScript
• Homepage:
• Size: 28.3 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Header Test MCP

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.md)

> header-test-mcp is an MCP Server which has one tool `get-request-headers` which returns all headers that were sent with the current request

Use this Server to debug your MCP Host / Client custom header implementation.

## Getting Started

### Prerequisites

Before you start with **sample-mcp-server**, ensure the following are installed:

- **[Node.js](https://nodejs.org/)** (v18 or above recommended)  

  Required to run the server and manage dependencies.

```bash

brew install node

```

- **[PNPM](https://pnpm.io/)** (v10 or above recommended)

  The project uses PNPM as its package manager.  

  Install globally with:

```bash

npm install -g pnpm

```

### Setup

Install dependencies:

```bash

pnpm i

```

Start MCP Server on localhost:3333 :

```bash

pnpm dev

```

Install dependencies & start server in one command:

```bash

pnpm d

```

**Server URL `http://localhost:3333/mcp`**

### Tunneling

If your host requires HTTPS you can easily tunnel the server via a service like [ngrok](https://ngrok.com/):

```bash

ngrok http 3333

```