Jakegaylor Com MCP Server

🚀 HTTP Server with MCP Support

This is an HTTP server built with Express and TypeScript, offering both web services and Model Context Protocol (MCP) endpoints.

🚀 Quick Start

This HTTP server combines web and MCP functionalities. It uses modern streaming for a stateless MCP server, TypeScript for type safety, and Express.js to handle HTTP requests.

✨ Features

• An HTTP server supporting both Web and MCP functionalities.
• A stateless MCP server implemented using modern streaming.
• Ensured type safety with TypeScript.
• Handled HTTP requests with Express.js.

📦 Installation

Prerequisites

• Node.js 18+
• npm or yarn

Steps

# Clone the repository (or download)
git clone https://github.com/your-username/jakegaylor-com-mcp-server.git
cd jakegaylor-com-mcp-server

# Install dependencies
npm install

💻 Usage Examples

Development

# Build TypeScript code
npm run build

# Run in development mode with auto-reloading
npm run dev

# Run tests (when added)
npm test

Server Structure

src/
  ├── index.ts                # Main entry point of the application
  ├── express.ts              # HTTP server configuration
  ├── stdio.ts                # STDIO server configuration
  ├── config.ts               # Server configuration
  └── types.ts                # TypeScript type definitions

Available Endpoints

The server supports multiple endpoints:

• Web (GET /): Provides web services.
• MCP (POST /mcp): Implements MCP protocol functions.

MCP Features

The MCP endpoint implements three MCP components:

• Resources: echo://{message} - Returns the message as a resource.
• Tools: echo - Echoes the provided message as a tool response.
• Prompts: echo - Creates a user prompt using the provided message.

MCP Protocol

The server implements the Model Context Protocol (MCP), a standardized way for large language models to interact with external data and functions. It provides a stateless API endpoint that responds to JSON - RPC requests.

API Usage

Send a POST request to /mcp with a JSON - RPC payload:

Initialization

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {
        "roots": {
          "listChanged": true
        },
        "sampling": {}
      },
      "clientInfo": {
        "name": "ExampleClient",
        "version": "1.0.0"
      }
    }
  }'

Call Echo Tool

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "echo",
      "arguments": {
        "message": "Hello, World!"
      }
    },
    "id": 1
  }'

📄 License

ISC

Regenerate Fly Deployment Key

The token was created using the following command: fly tokens create deploy --name gh-jakegaylor-com-mcp-server --expiry 2160h