Metadata-Version: 2.4
Name: hedgedoc-mcp-server
Version: 0.1.0
Summary: MCP server for HedgeDoc - create collaborative markdown notes with Mermaid diagrams
Project-URL: Homepage, https://github.com/julian-agama/hedgedoc-mcp-server
Project-URL: Repository, https://github.com/julian-agama/hedgedoc-mcp-server
Author-email: Julian Agama <julian@kaymer.pro>
License: MIT
Keywords: diagrams,hedgedoc,mcp,mermaid,opencode
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.0.0
Description-Content-Type: text/markdown

# HedgeDoc MCP Server

MCP server for [HedgeDoc](https://hedgedoc.org/) — create collaborative markdown notes with Mermaid diagrams from OpenCode and other MCP-compatible AI agents.

## Tools

| Tool | Description |
|---|---|
| `hedgedoc_create` | Create a new note with markdown content |
| `hedgedoc_read` | Read the raw markdown content of a note |
| `hedgedoc_info` | Get note metadata (title, description, timestamps) |
| `hedgedoc_create_diagram` | Create a note with a Mermaid diagram |

## Usage

```bash
export HEDGEDOC_URL="https://hedgedoc.your-instance.com"
# Optional: export HEDGEDOC_TOKEN="your-api-token"

uvx hedgedoc-mcp-server stdio
```

### OpenCode config

```jsonc
{
  "mcp": {
    "hedgedoc": {
      "type": "local",
      "enabled": true,
      "command": ["uvx", "hedgedoc-mcp-server", "stdio"],
      "environment": {
        "HEDGEDOC_URL": "https://hedgedoc.your-instance.com"
      }
    }
  }
}
```

## Requirements

- HedgeDoc 1.x instance
- Python 3.11+
- `uv` (recommended) or pip
