Supports package management and script execution for building and running the MCP server
Connects to a WebSocket echo server, enabling real-time bidirectional communication through the Echo resource
Built with TypeScript, enabling strongly-typed tool and resource development with compile-time type checking
Uses Zod for schema validation in tool development, providing type safety and input validation for MCP tools
mcp-remote-server
A Model Context Protocol (MCP) server built with mcp-framework.
Quick Start
The server will run on port 1947 at endpoint /mcp by default.
Related MCP server: mcp-server-code-assist
Project Structure
Included Tools
XkcdTool
Name:
xkcdDescription: Fetches a random xkcd comic image and its alt text.
Included Resources
DynamicResource
URI:
resource://market-dataDescription: Fetches data from JSONPlaceholder (free, no API key required).
EchoResource
URI:
resource://echoDescription: Connects to a public WebSocket echo server (
wss://echo.websocket.org).
StaticResource
URI:
resource://staticDescription: Returns static JSON data for testing.
Adding Components
You can add more tools using the CLI:
Tool Development Example
Running and Testing
Make changes to your tools or resources as needed.
Run
npm run buildto compile.Start the server with
npm start.The server will automatically load your tools and resources on startup.
Server Details
Port: 1947
Endpoint:
/mcpTransport: HTTP stream
Session management: Enabled
CORS: Enabled for all origins