From 2c22953542f1f2b5afc63ada032383953e01dec0 Mon Sep 17 00:00:00 2001 From: yctimlin Date: Mon, 12 May 2025 23:16:28 +0800 Subject: [PATCH] Update README.md to announce the release of version 1.0.0 on npm, enhance npx usage instructions, and add command-line options for server configuration. Include details for global installation and local development setup. --- README.md | 41 +++++++++++++++++++++++++++++++++++++++-- 1 file changed, 39 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 24b6e95..2e10bf3 100644 --- a/README.md +++ b/README.md @@ -1,17 +1,40 @@ # Excalidraw MCP Server: Powerful Drawing API for LLM Integration -> **📣 NEWS: We're excited to announce npx support!** You can now run Excalidraw MCP directly using `npx excalidraw-mcp` without installation. See Quick Start below for details. +> **📣 NEWS: Version 1.0.0 is now published to npm!** You can run Excalidraw MCP directly using `npx excalidraw-mcp` without installation. No setup required - just run and enjoy! A comprehensive Model Context Protocol (MCP) server that enables seamless interaction with Excalidraw diagrams and drawings. This server provides LLMs (Large Language Models) with the ability to create, modify, query, and manipulate Excalidraw drawings through a structured, developer-friendly API. ## Quick Start -You can run the Excalidraw MCP server directly using npx: +You can run the Excalidraw MCP server directly using npx without installing anything: ```bash npx excalidraw-mcp ``` +If you prefer to install it globally: + +```bash +npm install -g excalidraw-mcp +excalidraw-mcp +``` + +### Options + +The following command-line options are available: + +``` +-d, --debug Enable debug logging +-?, --help Show this help message +``` + +> **Note:** The following options are currently only fully functional in the Docker version: +> ``` +> -p, --port Port to run the server on (default: 3000) +> -h, --host Host to bind the server to (default: localhost) +> -m, --mode Transport mode: 'stdio' or 'http' (default: stdio) +> ``` + ### Examples Run with default options: @@ -138,6 +161,20 @@ To use this server with the Cursor application, add the following configuration ### NPM Installation ```bash +# Install globally +npm install -g excalidraw-mcp + +# Run the server +excalidraw-mcp +``` + +### Local Development Setup + +```bash +# Clone the repository +git clone +cd excalidraw-mcp + # Install dependencies npm install