iflow-mcp_Cam10001110101-mcp-server-jsoncanvas 0.1.0__tar.gz

iflow_mcp_cam10001110101_mcp_server_jsoncanvas-0.1.0/.context/.gitignore

@@ -0,0 +1,7 @@
+# Ignore everything in this directory
+*
+
+# Except this file
+!.gitignore
+# And the index.md file
+!index.md

iflow_mcp_cam10001110101_mcp_server_jsoncanvas-0.1.0/.context/index.md

@@ -0,0 +1,93 @@
+# JSON Canvas Project
+
+This project provides a Python library for working with JSON Canvas data structures according to the [official specification](https://jsoncanvas.org/spec/1.0/). It uses `uv` for Python package management and will be extended with a Model Context Protocol (MCP) server.
+
+## What is JSON Canvas?
+
+JSON Canvas is an open file format for infinite canvas data. It was originally created for [Obsidian](https://obsidian.md/blog/json-canvas/) and is designed to provide longevity, readability, interoperability, and extensibility to data created with infinite canvas apps.
+
+Infinite canvas tools are a way to view and organize information spatially, like a digital whiteboard. JSON Canvas files use the `.canvas` extension and follow a specific JSON structure.
+
+## Project Components
+
+This project consists of several components:
+
+1. **Python Library** - A library for working with JSON Canvas files
+2. **MCP Server** - A Model Context Protocol server for JSON Canvas operations
+3. **Examples** - Sample code demonstrating usage
+4. **Tests** - Unit tests for the library
+
+## Architecture
+
+The project follows a modular architecture:
+
+- `jsoncanvas/` - Main package directory
+  - `__init__.py` - Package initialization
+  - `canvas.py` - Core Canvas class implementation (to be updated to match spec)
+  - `nodes.py` - Node implementations (to be added)
+  - `edges.py` - Edge implementations (to be added)
+  - `validation.py` - Schema validation (to be added)
+- `tests/` - Test directory
+  - `test_canvas.py` - Tests for the Canvas class
+  - `test_nodes.py` - Tests for nodes (to be added)
+  - `test_edges.py` - Tests for edges (to be added)
+- `examples/` - Example scripts
+  - `create_canvas.py` - Example of creating a canvas
+- `mcp/` - MCP server implementation (to be added)
+
+## Development Workflow
+
+This project uses `uv` for Python package management. The workflow is:
+
+1. Create a virtual environment: `uv venv`
+2. Install dependencies: `uv pip install -r requirements.txt`
+3. Install development dependencies: `uv pip install -e ".[dev]"`
+4. Run tests: `pytest`
+
+## Key Components
+
+### Canvas Class
+
+The Canvas class will be updated to match the official JSON Canvas specification with:
+
+- Support for nodes (text, file, link, group)
+- Support for edges between nodes
+- Color handling
+- Validation against the specification
+
+### MCP Server
+
+The MCP server will provide tools for:
+
+- Validating JSON Canvas files
+- Creating and manipulating canvas elements
+- Converting between formats
+- Analyzing canvas structure
+- Generating visualizations
+
+See [mcp-server.md](mcp-server.md) for more details.
+
+### JSON Canvas Specification
+
+The project follows the JSON Canvas 1.0 specification. See [specification.md](specification.md) for details.
+
+### Project Documentation
+
+This project uses dotcontext for managing project documentation and context. The `.context` directory contains structured documentation about the project's architecture, components, and implementation details. See [dotcontext.md](dotcontext.md) for more information about how dotcontext is used in this project.
+
+## Implementation Plan
+
+1. Update the Python library to match the specification
+2. Implement validation using JSON Schema
+3. Create the MCP server
+4. Add examples and documentation
+5. Implement advanced features
+
+## Future Development
+
+Planned features include:
+- JSON schema validation for canvas elements
+- Export to different formats (SVG, PNG)
+- Canvas manipulation operations (resize, transform)
+- Real-time collaboration features
+- Integration with existing canvas tools

iflow_mcp_cam10001110101_mcp_server_jsoncanvas-0.1.0/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

iflow_mcp_cam10001110101_mcp_server_jsoncanvas-0.1.0/.gitignore

@@ -0,0 +1,45 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+.venv/
+venv/
+ENV/
+
+# UV specific
+.uv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS specific
+.DS_Store
+Thumbs.db
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+.tox/

iflow_mcp_cam10001110101_mcp_server_jsoncanvas-0.1.0/3280_process.log

@@ -0,0 +1,6 @@
+2026-02-06 09:53:26 [INFO] 开始处理项目: mcp-server-obsidian-jsoncanvas
+2026-02-06 09:53:36 [INFO] 项目语言类型: python
+2026-02-06 09:55:59 [INFO] 包名: iflow-mcp_Cam10001110101-mcp-server-jsoncanvas
+2026-02-06 09:56:26 [INFO] 项目构建成功
+2026-02-06 10:07:47 [INFO] 本地测试成功，检测到2个工具
+2026-02-06 10:07:59 [INFO] Git推送成功

iflow_mcp_cam10001110101_mcp_server_jsoncanvas-0.1.0/Dockerfile

@@ -0,0 +1,37 @@
+FROM python:3.10-slim as builder
+
+WORKDIR /app
+
+# Install build dependencies
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+    build-essential \
+    curl && \
+    rm -rf /var/lib/apt/lists/*
+
+# Install uv
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Copy project files
+COPY . .
+
+# Install dependencies and build project using uv
+RUN /root/.cargo/bin/uv pip install --system .
+
+# Create final image
+FROM python:3.10-slim
+
+WORKDIR /app
+
+# Copy built files from builder
+COPY --from=builder /app /app
+
+# Create data directory
+RUN mkdir -p /data/output
+
+# Set environment variables
+ENV OUTPUT_PATH=/data/output
+ENV FORMAT=json
+
+# Run the server
+ENTRYPOINT ["python", "-m", "jsoncanvas"]

iflow_mcp_cam10001110101_mcp_server_jsoncanvas-0.1.0/EXAMPLE OUTPUT/2025-03-03-austin_langchain_aimug.canvas

@@ -0,0 +1,26 @@
+{
+	"nodes":[
+		{"id":"events_group","type":"group","x":150,"y":450,"width":1000,"height":250,"color":"#EA4335","label":"Events & Activities"},
+		{"id":"resources_group","type":"group","x":150,"y":750,"width":1000,"height":200,"color":"#673AB7","label":"Resources"},
+		{"id":"title","type":"text","text":"# Austin LangChain AI Meetup Group\n\nA community for AI enthusiasts and developers in Austin, TX","x":400,"y":-80,"width":500,"height":160,"color":"#4285F4"},
+		{"id":"about","type":"text","text":"## About the Group\n\nThe Austin LangChain AI Meetup Group brings together developers, researchers, and enthusiasts interested in LangChain, LLMs, and AI application development. We focus on knowledge sharing, networking, and collaborative learning.","x":150,"y":120,"width":350,"height":280,"color":"#34A853"},
+		{"id":"langchain","type":"text","text":"## What is LangChain?\n\nLangChain is a framework for developing applications powered by language models. It enables:\n\n- Connecting LLMs to other sources of data\n- Creating interactive agents\n- Building context-aware applications","x":800,"y":200,"width":350,"height":200,"color":"#FBBC05"},
+		{"id":"workshops","type":"text","text":"## Workshops\n\n- Hands-on LangChain tutorials\n- Building AI applications\n- Integration with vector databases\n- RAG implementation techniques","x":200,"y":500,"width":250,"height":150,"color":"#4285F4"},
+		{"id":"talks","type":"text","text":"## Speaker Series\n\n- Industry experts\n- Academic researchers\n- Open source contributors\n- Local AI startups\n- Use case demonstrations","x":500,"y":500,"width":250,"height":150,"color":"#34A853"},
+		{"id":"hackathons","type":"text","text":"## Hackathons\n\n- Weekend coding events\n- Team-based challenges\n- Mentorship opportunities\n- Prizes and recognition\n- Networking with peers","x":800,"y":500,"width":250,"height":150,"color":"#FBBC05"},
+		{"id":"website","type":"text","text":"## [AIMUG Website](https://aimug.org)\n\nOfficial website for the Austin AI Meetup Group","x":200,"y":800,"width":250,"height":100,"color":"#4285F4"},
+		{"id":"github","type":"text","text":"## [LangChain GitHub](https://github.com/langchain-ai/langchain)\n\nSource code and documentation","x":500,"y":800,"width":250,"height":100,"color":"#333333"},
+		{"id":"discord","type":"text","text":"## [LangChain Discord](https://discord.gg/langchain)\n\nCommunity discussions and support","x":800,"y":800,"width":250,"height":100,"color":"#7289DA"},
+		{"id":"join","type":"text","text":"## Join the Community\n\nConnect with AI enthusiasts and LangChain developers in Austin! Our meetups are open to all skill levels, from beginners to experts. We welcome developers, researchers, students, and anyone interested in AI and LLM applications.","x":400,"y":1000,"width":500,"height":220,"color":"#FF5722"}
+	],
+	"edges":[
+		{"id":"edge1","fromNode":"title","fromSide":"bottom","toNode":"about","toSide":"top"},
+		{"id":"edge2","fromNode":"title","fromSide":"bottom","toNode":"langchain","toSide":"top"},
+		{"id":"edge3","fromNode":"about","fromSide":"bottom","toNode":"events_group","toSide":"top"},
+		{"id":"edge4","fromNode":"langchain","fromSide":"bottom","toNode":"events_group","toSide":"top"},
+		{"id":"edge5","fromNode":"events_group","fromSide":"bottom","toNode":"resources_group","toSide":"top"},
+		{"id":"edge6","fromNode":"resources_group","fromSide":"bottom","toNode":"join","toSide":"top"},
+		{"id":"edge7","fromNode":"langchain","fromSide":"bottom","toNode":"github","toSide":"top","label":"Source Code"},
+		{"id":"edge8","fromNode":"langchain","fromSide":"bottom","toNode":"discord","toSide":"top","label":"Community"}
+	]
+}

iflow_mcp_cam10001110101_mcp_server_jsoncanvas-0.1.0/EXAMPLE OUTPUT/2025-03-03-bears_of_the_world.canvas

@@ -0,0 +1,23 @@
+{
+	"nodes":[
+		{"id":"polar","type":"text","text":"## Polar Bear\n\n- Scientific name: *Ursus maritimus*\n- Habitat: Arctic sea ice\n- Diet: Primarily seals\n- Status: Vulnerable\n\nThe largest bear species and the largest land carnivore.","x":100,"y":200,"width":300,"height":200,"color":"#FFFFFF"},
+		{"id":"grizzly","type":"text","text":"## Grizzly Bear\n\n- Scientific name: *Ursus arctos horribilis*\n- Habitat: Forests, mountains, tundra\n- Diet: Omnivorous\n- Status: Least Concern\n\nKnown for their distinctive shoulder hump and long claws.","x":450,"y":200,"width":300,"height":200,"color":"#8B4513"},
+		{"id":"panda","type":"text","text":"## Giant Panda\n\n- Scientific name: *Ailuropoda melanoleuca*\n- Habitat: Bamboo forests in China\n- Diet: 99% bamboo\n- Status: Vulnerable\n\nIconic black and white bear, symbol of conservation.","x":800,"y":200,"width":300,"height":200,"color":"#000000"},
+		{"id":"conservation","type":"text","text":"## Conservation\n\nMany bear species face threats from habitat loss, poaching, and climate change. Conservation efforts include habitat protection, anti-poaching measures, and breeding programs.","x":400,"y":700,"width":500,"height":200,"color":"#4CAF50"},
+		{"id":"resources","type":"link","url":"https://www.worldwildlife.org/species/bear","x":400,"y":1000,"width":500,"height":480,"color":"#2196F3"},
+		{"id":"title","type":"text","text":"# Bears of the World\n\nAn overview of different bear species","x":350,"y":-200,"width":500,"height":100,"color":"#4285F4"},
+		{"id":"black","type":"text","text":"## American Black Bear\n\n- Scientific name: *Ursus americanus*\n- Habitat: Forests across North America\n- Diet: Omnivorous\n- Status: Least Concern\n\nMost common bear in North America.","x":-50,"y":550,"width":300,"height":350,"color":"#333333"},
+		{"id":"sloth","type":"text","text":"## Sloth Bear\n\n- Scientific name: *Melursus ursinus*\n- Habitat: Forests in South Asia\n- Diet: Insects, fruits, honey\n- Status: Vulnerable\n\nKnown for their shaggy coat and long snout.","x":1100,"y":580,"width":300,"height":200,"color":"#654321"},
+		{"id":"sun","type":"text","text":"## Sun Bear\n\n- Scientific name: *Helarctos malayanus*\n- Habitat: Tropical forests in Southeast Asia\n- Diet: Omnivorous, loves honey\n- Status: Vulnerable\n\nThe smallest bear species with a distinctive chest patch.","x":1140,"y":200,"width":300,"height":200,"color":"#FFA500"}
+	],
+	"edges":[
+		{"id":"edge1","fromNode":"title","fromSide":"bottom","toNode":"polar","toSide":"top"},
+		{"id":"edge2","fromNode":"title","fromSide":"bottom","toNode":"grizzly","toSide":"top"},
+		{"id":"edge3","fromNode":"title","fromSide":"bottom","toNode":"panda","toSide":"top"},
+		{"id":"edge4","fromNode":"conservation","fromSide":"top","toNode":"polar","toSide":"bottom"},
+		{"id":"edge5","fromNode":"conservation","fromSide":"top","toNode":"panda","toSide":"bottom"},
+		{"id":"edge6","fromNode":"conservation","fromSide":"top","toNode":"sun","toSide":"bottom"},
+		{"id":"edge7","fromNode":"conservation","fromSide":"top","toNode":"sloth","toSide":"bottom"},
+		{"id":"edge8","fromNode":"conservation","fromSide":"bottom","toNode":"resources","toSide":"top"}
+	]
+}

iflow_mcp_cam10001110101_mcp_server_jsoncanvas-0.1.0/EXAMPLE OUTPUT/2025-03-03-cavapoos_guide.canvas

@@ -0,0 +1,28 @@
+{
+	"nodes":[
+		{"id":"appearance","type":"text","text":"## Appearance\n\n- Size: Small to medium (9-14 inches tall)\n- Weight: 12-25 pounds\n- Coat: Soft, wavy to curly\n- Colors: Various (cream, gold, chestnut, tricolor)\n- Ears: Floppy\n- Lifespan: 10-15 years","x":100,"y":400,"width":300,"height":200,"color":"#FFD166"},
+		{"id":"temperament","type":"text","text":"## Temperament\n\n- Friendly and affectionate\n- Intelligent and trainable\n- Good with children and other pets\n- Sociable and outgoing\n- Low to moderate energy level\n- Eager to please","x":450,"y":400,"width":300,"height":200,"color":"#06D6A0"},
+		{"id":"health","type":"text","text":"## Health Considerations\n\n- Inherited conditions from parent breeds\n- Potential issues: heart problems, eye disorders, hip dysplasia\n- Regular vet check-ups recommended\n- Dental care important\n- Typically healthy when from reputable breeders","x":100,"y":650,"width":300,"height":200,"color":"#EF476F"},
+		{"id":"history","type":"text","text":"## History & Origin\n\n- Developed in the 1990s\n- Designer breed created for companionship\n- Combines best traits of both parent breeds\n- Gained popularity for hypoallergenic qualities\n- Not recognized by major kennel clubs as a purebred","x":1180,"y":850,"width":300,"height":200,"color":"#540D6E"},
+		{"id":"care","type":"text","text":"## Care Requirements\n\n- Grooming: Regular brushing, professional grooming every 6-8 weeks\n- Exercise: Daily walks, playtime\n- Training: Responds well to positive reinforcement\n- Diet: High-quality dog food appropriate for size and age","x":1030,"y":400,"width":300,"height":350,"color":"#118AB2"},
+		{"id":"adoption","type":"text","text":"## Adoption & Cost\n\nCavapoos typically cost $1,500-$4,000 from reputable breeders. Consider rescue organizations that may have Cavapoo mixes. Always research breeders thoroughly and avoid puppy mills.","x":120,"y":1030,"width":500,"height":150,"color":"#F77F00"},
+		{"id":"training","type":"text","text":"## Training & Exercise\n\n- Highly trainable due to intelligence\n- Eager to please and responsive\n- Early socialization important\n- Moderate exercise needs (30-60 minutes daily)\n- Enjoys interactive toys and games\n- Can excel at agility and obedience","x":700,"y":663,"width":300,"height":375,"color":"#073B4C"},
+		{"id":"resources","type":"link","url":"https://www.akc.org/expert-advice/dog-breeds/cavapoo-breed-facts-temperament-traits/","x":120,"y":1340,"width":500,"height":320,"color":"#2196F3"},
+		{"id":"title","type":"text","text":"# Cavapoos\n\nA comprehensive guide to the Cavalier King Charles Spaniel and Poodle mix","x":300,"y":-140,"width":500,"height":180,"color":"#FF6B6B"},
+		{"id":"overview","type":"text","text":"## Overview\n\nCavapoos are a crossbreed between a Cavalier King Charles Spaniel and a Poodle. They are known for their friendly temperament, intelligence, and hypoallergenic coat. They're popular family pets due to their gentle nature and adaptability.","x":350,"y":100,"width":500,"height":180,"color":"#4ECDC4"}
+	],
+	"edges":[
+		{"id":"edge1","fromNode":"title","fromSide":"bottom","toNode":"overview","toSide":"top"},
+		{"id":"edge2","fromNode":"overview","fromSide":"bottom","toNode":"appearance","toSide":"top"},
+		{"id":"edge3","fromNode":"overview","fromSide":"bottom","toNode":"temperament","toSide":"top"},
+		{"id":"edge4","fromNode":"overview","fromSide":"bottom","toNode":"care","toSide":"top"},
+		{"id":"edge5","fromNode":"appearance","fromSide":"bottom","toNode":"health","toSide":"top"},
+		{"id":"edge6","fromNode":"temperament","fromSide":"bottom","toNode":"training","toSide":"top"},
+		{"id":"edge7","fromNode":"care","fromSide":"bottom","toNode":"health","toSide":"top"},
+		{"id":"edge8","fromNode":"overview","fromSide":"right","toNode":"history","toSide":"top"},
+		{"id":"edge9","fromNode":"health","fromSide":"bottom","toNode":"adoption","toSide":"left"},
+		{"id":"edge10","fromNode":"training","fromSide":"bottom","toNode":"adoption","toSide":"top"},
+		{"id":"edge11","fromNode":"history","fromSide":"bottom","toNode":"adoption","toSide":"right"},
+		{"id":"edge12","fromNode":"adoption","fromSide":"bottom","toNode":"resources","toSide":"top"}
+	]
+}

iflow_mcp_cam10001110101_mcp_server_jsoncanvas-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 JSON Canvas MCP Server Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

iflow_mcp_cam10001110101_mcp_server_jsoncanvas-0.1.0/Makefile

@@ -0,0 +1,41 @@
+.PHONY: setup test lint format clean
+
+# Create virtual environment and install dependencies
+setup:
+	uv venv
+	uv pip install -r requirements.txt
+	uv pip install -e ".[dev]"
+
+# Run tests
+test:
+	pytest
+
+# Run linting
+lint:
+	black --check jsoncanvas tests examples
+	isort --check jsoncanvas tests examples
+	mypy jsoncanvas tests examples
+
+# Format code
+format:
+	black jsoncanvas tests examples
+	isort jsoncanvas tests examples
+
+# Run example
+example:
+	python examples/create_canvas.py
+
+# Clean up generated files
+clean:
+	rm -rf .pytest_cache
+	rm -rf .coverage
+	rm -rf htmlcov
+	rm -rf dist
+	rm -rf build
+	rm -rf *.egg-info
+	rm -rf output
+	find . -type d -name __pycache__ -exec rm -rf {} +
+	find . -type d -name "*.egg-info" -exec rm -rf {} +
+	find . -type f -name "*.pyc" -delete
+	find . -type f -name "*.pyo" -delete
+	find . -type f -name "*.pyd" -delete

iflow_mcp_cam10001110101_mcp_server_jsoncanvas-0.1.0/PKG-INFO

@@ -0,0 +1,241 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_Cam10001110101-mcp-server-jsoncanvas
+Version: 0.1.0
+Summary: MCP server for working with JSON Canvas files
+Project-URL: Homepage, https://github.com/yourusername/mcp-server-jsoncanvas
+Project-URL: Repository, https://github.com/yourusername/mcp-server-jsoncanvas.git
+Author-email: Your Name <your.email@example.com>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: jsonschema>=4.20.0
+Requires-Dist: mcp>=1.2.0
+Requires-Dist: pillow>=10.1.0
+Requires-Dist: svgwrite>=1.4.3
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=7.4.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# JSON Canvas MCP Server
+
+A Model Context Protocol (MCP) server implementation that provides tools for working with JSON Canvas files according to the [official specification](https://jsoncanvas.org/spec/1.0/). This server enables creating, modifying, and validating infinite canvas data structures.
+
+## Overview
+
+The JSON Canvas MCP server provides a complete implementation of the JSON Canvas 1.0 specification, enabling:
+
+- Creation and manipulation of infinite canvas data
+- Support for all node types (text, file, link, group)
+- Edge connections with styling and labels
+- Validation against the specification
+- Configurable output paths
+
+## Components
+
+### Resources
+
+The server exposes the following resources:
+
+- `canvas://schema`: JSON Schema for validating canvas files
+- `canvas://examples`: Example canvas files demonstrating different features
+- `canvas://templates`: Templates for creating new canvases
+
+### Tools
+
+#### Node Operations
+
+- **create_node**
+  - Create a new node of any supported type
+  - Input:
+    - `type` (string): Node type ("text", "file", "link", "group")
+    - `properties` (object): Node-specific properties
+      - Common: `id`, `x`, `y`, `width`, `height`, `color`
+      - Type-specific: `text`, `file`, `url`, etc.
+  - Returns: Created node object
+
+- **update_node**
+  - Update an existing node's properties
+  - Input:
+    - `id` (string): Node ID to update
+    - `properties` (object): Properties to update
+  - Returns: Updated node object
+
+- **delete_node**
+  - Remove a node and its connected edges
+  - Input:
+    - `id` (string): Node ID to delete
+  - Returns: Success confirmation
+
+#### Edge Operations
+
+- **create_edge**
+  - Create a new edge between nodes
+  - Input:
+    - `id` (string): Unique edge identifier
+    - `fromNode` (string): Source node ID
+    - `toNode` (string): Target node ID
+    - `fromSide` (optional string): Start side ("top", "right", "bottom", "left")
+    - `toSide` (optional string): End side
+    - `color` (optional string): Edge color
+    - `label` (optional string): Edge label
+  - Returns: Created edge object
+
+- **update_edge**
+  - Update an existing edge's properties
+  - Input:
+    - `id` (string): Edge ID to update
+    - `properties` (object): Properties to update
+  - Returns: Updated edge object
+
+- **delete_edge**
+  - Remove an edge
+  - Input:
+    - `id` (string): Edge ID to delete
+  - Returns: Success confirmation
+
+#### Canvas Operations
+
+- **validate_canvas**
+  - Validate a canvas against the specification
+  - Input:
+    - `canvas` (object): Canvas data to validate
+  - Returns: Validation results with any errors
+
+- **export_canvas**
+  - Export canvas to different formats
+  - Input:
+    - `format` (string): Target format ("json", "svg", "png")
+    - `canvas` (object): Canvas data to export
+  - Returns: Exported canvas in requested format
+
+## Usage with Claude Desktop
+
+### Docker
+
+Add this to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "jsoncanvas": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "-v",
+        "canvas-data:/data",
+        "mcp/jsoncanvas"
+      ],
+      "env": {
+        "OUTPUT_PATH": "/data/output"
+      }
+    }
+  }
+}
+```
+
+### UV
+
+```json
+{
+  "mcpServers": {
+    "jsoncanvas": {
+      "command": "uv",
+      "args": [
+        "--directory",
+        "/path/to/jsoncanvas",
+        "run",
+        "mcp-server-jsoncanvas"
+      ],
+      "env": {
+        "OUTPUT_PATH": "./output"
+      }
+    }
+  }
+}
+```
+
+## Configuration
+
+The server can be configured using environment variables:
+
+- `OUTPUT_PATH`: Directory where canvas files will be saved (default: "./output")
+- `FORMAT`: Default output format for canvas files (default: "json")
+
+## Building
+
+### Docker Build
+
+```bash
+docker build -t mcp/jsoncanvas .
+```
+
+### Local Build
+
+```bash
+# Install uv if not already installed
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Create virtual environment and install dependencies
+uv venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+uv pip install -e .
+
+# Run tests
+pytest
+```
+
+## Example Usage
+
+### Creating a Canvas
+
+```python
+from jsoncanvas import Canvas, TextNode, Edge
+
+# Create nodes
+title = TextNode(
+    id="title",
+    x=100,
+    y=100,
+    width=400,
+    height=100,
+    text="# Hello Canvas\n\nThis is a demonstration.",
+    color="#4285F4"
+)
+
+info = TextNode(
+    id="info",
+    x=600,
+    y=100,
+    width=300,
+    height=100,
+    text="More information here",
+    color="2"  # Using preset color
+)
+
+# Create canvas
+canvas = Canvas()
+canvas.add_node(title)
+canvas.add_node(info)
+
+# Connect nodes
+edge = Edge(
+    id="edge1",
+    from_node="title",
+    to_node="info",
+    from_side="right",
+    to_side="left",
+    label="Connection"
+)
+canvas.add_edge(edge)
+
+# Save canvas
+canvas.save("example.canvas")
+```
+
+## License
+
+This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.