Grareco

MCP Grareco is an MCP server that creates graphic recordings from arbitrary URLs or text, leveraging MCP protocol features to generate visual summaries you can share or analyze later.

How to use

You run the MCP Grareco server and connect to it with an MCP client. The server exposes two primary ways to generate graphic recordings: from a web page and from plain text. Use the standard HTTP endpoint or the local stdio command depending on your setup.

From a web page you can request a conversion by using the webToGrareco tool. It accepts a URL and an optional prompt type to shape the resulting graphic recording HTML. The prompt types are standard, elementary, or timeline. The server will emit progress notifications as it processes.

From text you can request a graphic recording by using the textToGrareco tool. It accepts a text string and an optional prompt type (standard, elementary, timeline). The server will emit progress notifications as it processes and will return the path to the generated HTML file.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

npm install

Build the project to prepare the runtime artifacts.

npm run build

Run the server in STDIO mode for local usage.

npm run start

Or run the server in SSE mode to enable server-sent events for progress updates.

npm run start:sse

Configuration and usage notes

You can configure how you connect to the Grareco MCP server in your client settings. The following examples show how to add the Grareco server in your MCP client configuration.

If you want to run Grareco as a local stdio server, use this JSON configuration snippet in your client settings.

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

If you prefer to connect to a remote server endpoint over HTTP/SSE, use this HTTP configuration snippet.

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

Available tools

echo

Echoes back the input message to simulate a basic tool used for simple input testing.

printEnv

Displays all environment variables, useful for debugging MCP server configuration.

webToGrareco

Fetches a web page from a URL and converts it into a graphic recording HTML file, returning the saved HTML path and streaming progress updates during processing.

textToGrareco

Converts input text into a graphic recording HTML file, returning the saved HTML path and streaming progress updates during processing.