Official description7 sourcesMCP servers8d ago

juergenkoller-software/inkra-mcp

Open-source MCP server bridge for Inkra — drive a native macOS Markdown editor (live KaTeX/Mermaid preview) from Claude/Cursor.

View on GitHub ↗Direct link · no redirect page

Config template (adjust for your client)

claude mcp add inkra-mcp -- npx -y inkra-mcp

A pasteable skeleton generated from the repository name. Check the project README for the exact package and arguments.

Star count: 1 ★ · juergenkoller-software/inkra-mcp · read from the GitHub search API · (checked 2026-10-16 20:00:20)
Source: collected from the punkpeye/awesome-mcp-servers list · type: MCP server
Harvest history: first seen 2026-10-09 · last seen 2026-10-16 · seen 32× · listed by 7 sources
Score: score 703 · 1 ★ · 7 sources · mcp

FAQ (answers come from our records)

How do I install it?

We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.

Who is it for?

We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.

Who maintains it?

repository juergenkoller-software/inkra-mcp；first catalogued 2026-10-09；last seen 2026-10-16。There is no official certification or quality rating here — we record sources and dates only.

Third-party quality signals

Inkra MCP Server

以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →

**Drive a native macOS Markdown editor from Claude, Cursor, or any MCP client.**
This is the official Model Context Protocol bridge for **Inkra** — a native macOS Markdown editor (SwiftUI + AppKit, not Electron) with live KaTeX/Mermaid preview and a built-in AI assistant.
> **You need the Inkra app installed and running.** This MCP server is a stdio→HTTP bridge — Inkra owns the document state, undo stack, syntax highlighting, and rendering. Get Inkra at store.juergenkoller.software/apps/inkra.
---
What you can do
> "Claude, open ~/Notes/2026-thesis.md, find every heading that contains 'TODO', add a checkbox after it, and save."
>
> "Cursor, list all files in the current folder, bookmark the H2 'Methodology', and switch to Focus Mode."
The MCP server exposes **18 tools** across these categories:
| Category | Tools |
|---|---|
| **Document content** | document_get_content, document_set_content, document_insert, document_replace, document_search |
| **Document lifecycle** | document_open, document_create, document_save |
| **Navigation** | outline_get, bookmarks_list, bookmark_add, bookmark_remove |
| **Folder / files** | folder_open, folder_list_files |
| **Metadata** | frontmatter_get (YAML front-matter parser) |
| **View** | theme_set (standard / sepia / night), view_mode_set (focus / wide) |
| **State** | window_info |
Every tool operates on the **currently open document** in the Inkra app — so AI agents see exactly what you see, edits show up live with syntax highlighting and preview, and undo/redo work in the app's normal undo stack.
---
Installation
Prerequisites
1. **macOS 14 (Sonoma) or later**
2. **Inkra app installed and running** — get it here (free during beta, available on Mac App Store and direct download)
3. **Swift 5.9+** (Xcode 15+) if building from source
Build from source
Pre-built binary
See Releases.
---
Configuration
Claude Desktop
Get INKRA_TOKEN from **Inkra → Settings → API & Integrations**.
Claude Code
Cursor / other MCP clients
Same pattern — stdio MCP server, two env vars.
---
How it works
The bridge forwards JSON-RPC over stdio to Inkra's local HTTP MCP endpoint. The app handles document state (NSTextView with TextKit 2), AST-based syntax highlighting, KaTeX/Mermaid live preview, undo/redo, session restore, and exports.
---
Environment variables
| Variable | Default | Description |
|---|---|---|
| INKRA_PORT | 22300 | Port of Inkra's local HTTP server |
| INKRA_TOKEN | _(none)_ | Bearer token from Inkra Settings (required) |
---
About Inkra
Inkra is a native macOS Markdown editor — **not** an Electron app. Highlights:
- **Native** — SwiftUI + AppKit, real macOS performance