mcp-remote-server

A Model Context Protocol (MCP) server built with mcp-framework.

Quick Start

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

The server will run on port 1947 at endpoint /mcp by default.

Project Structure

mcp-remote-server/
├── src/
│   ├── tools/                # MCP Tools
│   │   └── XkcdTool.ts       # Tool: Fetches random xkcd comics
│   ├── resources/            # MCP Resources
│   │   ├── DynamicResource.ts  # Fetches data from JSONPlaceholder
│   │   ├── RealTimeResource.ts # Echo WebSocket resource
│   │   └── StaticResource.ts   # Returns static JSON data
│   └── index.ts              # Server entry point
├── package.json
├── tsconfig.json
└── README.md

Included Tools

XkcdTool

Name: xkcd
Description: Fetches a random xkcd comic image and its alt text.

Included Resources

DynamicResource

URI: resource://market-data
Description: Fetches data from JSONPlaceholder (free, no API key required).

EchoResource

URI: resource://echo
Description: Connects to a public WebSocket echo server (wss://echo.websocket.org).

StaticResource

URI: resource://static
Description: Returns static JSON data for testing.

Adding Components

You can add more tools using the CLI:

# Add a new tool
mcp add tool my-tool

Tool Development Example

import { MCPTool } from "mcp-framework";
import { z } from "zod";

interface MyToolInput {
  message: string;
}

class MyTool extends MCPTool<MyToolInput> {
  name = "my_tool";
  description = "Describes what your tool does";

  schema = {
    message: {
      type: z.string(),
      description: "Description of this input parameter",
    },
  };

  async execute(input: MyToolInput) {
    // Your tool logic here
    return `Processed: ${input.message}`;
  }
}

export default MyTool;

Running and Testing

Make changes to your tools or resources as needed.
Run npm run build to compile.
Start the server with npm start.
The server will automatically load your tools and resources on startup.

Server Details

Port: 1947
Endpoint: /mcp
Transport: HTTP stream
Session management: Enabled
CORS: Enabled for all origins

Learn More

This server cannot be installed

security - not tested

license - not found

quality - not tested

A Model Context Protocol server that provides tools for fetching xkcd comics and resources for dynamic data retrieval, WebSocket echo functionality, and static JSON data testing.

Related MCP Servers

@kazuph/mcp-fetch
kazuph
A
security
A
license
A
quality
Model Context Protocol server for fetching web content and processing images. This allows Claude Desktop (or any MCP client) to fetch web content and handle images appropriately.
Last updated -
1
278
15
JavaScript
MIT License
MCP Server Fetch TypeScript
tatn
A
security
A
license
A
quality
A Model Context Protocol server that provides web content fetching and conversion capabilities.
Last updated -
4
89
2
JavaScript
MIT License
MCP Server for Cursor
AntDX316
-
security
F
license
-
quality
A Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.
Last updated -
1,133
1
Python
Xano MCP Server for Smithery
roboulos
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude AI to interact with Xano databases, providing comprehensive database operations, file management, and request history tracking through a standardized interface.
Last updated -
Python
MIT License

View all related MCP servers

mcp-remote-server

mcp-remote-server

Quick Start

Project Structure

Included Tools

XkcdTool

Included Resources

DynamicResource

EchoResource

StaticResource

Adding Components

Tool Development Example

Running and Testing

Server Details

Learn More

Related MCP Servers

@kazuph/mcp-fetch

MCP Server Fetch TypeScript

MCP Server for Cursor

Xano MCP Server for Smithery

New MCP Servers

MCP directory API