MCP Grareco

This is an MCP server for generating graphic recordings. It leverages the capabilities of the MCP protocol to convert the content of any URL or arbitrary string into a graphic recording.

Components

Tools

1. echo

   • A simple tool that echoes back the input message
   • Input:
     • message (string): The message to echo back
   • Return: Text containing the echoed message

2. printEnv

   • Displays all environment variables
   • Useful for debugging MCP server configurations
   • Input: None
   • Return: A JSON string of all environment variables

3. webToGrareco

   • Fetches a website from a URL and converts it into HTML in graphic recording format
   • Input:
     • url (string): The URL of the website to be converted
     • promptType (enum: "standard" | "elementary" | "timeline", default: "standard"): The type of prompt to use (standard, elementary, timeline)
   • Return: The save path of the generated HTML file
   • Sends progress notifications during processing

4. textToGrareco

   • Converts text into HTML in graphic recording format
   • Input:
     • text (string): The text to be converted
     • promptType (enum: "standard" | "elementary" | "timeline", default: "standard"): The type of prompt to use (standard, elementary, timeline)
   • Return: The save path of the generated HTML file
   • Sends progress notifications during processing

Logging

The server sends log messages at random levels every 15 seconds, e.g.:

json
{
"method": "notifications/message",
"params": {
"level": "info",
"data": "Info-level message"
}
}

Usage

Running Locally

bash

Install

npm install

Build

npm run build

Run (STDIO mode)

npm run start

Run (SSE mode)

npm run start:sse

Using with Claude Desktop

Add the following to cline_mcp_settings.json:

Example 1:
json
{
"mcpServers": {
"grareco": {
"command": "npx",
"args": [
"-y",
"mcp_grareco"
]
}
}
}

Example 2:
json
{
"mcpServers": {
"grareco": {
"url": "http://localhost:3000/sse",
"headers": {},
"timeout": 900
}
}
}