Inkra Mcp

Inkra MCP サーバー

Claude、Cursor、または任意の MCP クライアントから、ネイティブの macOS Markdown エディターを操作できます。

これは、Inkra 向けの公式 Model Context Protocol ブリッジです。Inkra は、ライブ KaTeX／Mermaid プレビューと AI アシスタントを内蔵したネイティブ macOS Markdown エディターです（Electron ではなく、SwiftUI + AppKit で構築されています）。

Inkra アプリをインストールして起動し、Inkra Pro を利用できる状態にしてください。 この MCP サーバーは stdio→HTTP ブリッジです。ドキュメントの状態、元に戻す履歴、構文ハイライト、レンダリングは Inkra が管理します。MCP サーバーと REST API は Inkra Pro の一部で、無料トライアルにも含まれています。store.juergenkoller.software/apps/inkra から Inkra を入手できます。

Web サイト版の Inkra には、inkra-mcp-server としてこのブリッジがすでに含まれています。Inkra → Settings → API → Copy MCP Config を選ぶと、すぐに使える設定を取得できます。このリポジトリからビルドするのは、ブリッジを監査または変更したい場合だけです。

---

できること

「Claude、~/Notes/2026-thesis.md を開き、'TODO' を含む見出しをすべて探して、その後ろにチェックボックスを追加して保存してください。」

「Cursor、現在のフォルダー内のファイルをすべて一覧表示し、H2 の 'Methodology' をブックマークして、フォーカスモードに切り替えてください。」

MCP サーバーは、以下のカテゴリにわたる 18 個のツールを公開します。

カテゴリ	ツール
ドキュメントの内容	document_get_content、document_set_content、document_insert、document_replace、document_search
ドキュメントのライフサイクル	document_open、document_create、document_save
ナビゲーション	outline_get、bookmarks_list、bookmark_add、bookmark_remove
フォルダー／ファイル	folder_open、folder_list_files
メタデータ	frontmatter_get（YAML front-matter パーサー）
表示	theme_set（standard / sepia / night）、view_mode_set（focus / wide）
状態	window_info

各ツールは、Inkra アプリで現在開いているドキュメントを操作します。そのため AI エージェントには画面に表示されている内容がそのまま伝わり、編集内容は構文ハイライトとプレビューにリアルタイムで反映されます。また、アプリ標準の元に戻す履歴で、元に戻す／やり直す操作もできます。

---

インストール

前提条件

1. macOS 14（Sonoma）以降
2. Inkra アプリがインストールされ、起動していること — こちらから入手（Web サイト版。Mac App Store 版には MCP サーバーが含まれていません）
3. Inkra Pro、または無料トライアル — これがない場合、アプリはすべての MCP 呼び出しに「Inkra Pro required」と応答します
4. Inkra → Settings → API で API を有効にすること（「API Enabled」）
5. Swift 5.9+（Xcode 15+）— ソースからビルドする場合のみ

アプリ内のブリッジを使用する（推奨）

/Applications/Inkra.app/Contents/MacOS/inkra-mcp-server

インストール済みアプリのバージョンに常に一致します。

ソースからビルドする

git clone https://github.com/juergenkoller-software/inkra-mcp.git
cd inkra-mcp
swift build -c release
# Binary: .build/release/InkraMCP

ビルド済みバイナリ

Mac では不要です。Web サイト版の Inkra にブリッジが含まれています（上記を参照）。Releases に添付されているバイナリは、Glama などのコンテナー型 MCP レジストリ向けの静的 Linux x86_64 ビルドであり、macOS では動作しません。

---

設定

Claude Desktop

{
  "mcpServers": {
    "inkra": {
      "command": "/Applications/Inkra.app/Contents/MacOS/inkra-mcp-server",
      "env": {
        "INKRA_API_PORT": "42932",
        "INKRA_API_TOKEN": "your-token-here"
      }
    }
  }
}

Inkra → Settings → API から INKRA_API_TOKEN を取得するか、そこで Copy MCP Config を使用してください。パス、ポート、トークンが入力されます。

Claude Code

claude mcp add inkra /Applications/Inkra.app/Contents/MacOS/inkra-mcp-server \
  --env INKRA_API_PORT=42932 \
  --env INKRA_API_TOKEN=your-token-here

Cursor／その他の MCP クライアント

同じパターンです。stdio MCP サーバーと 2 つの環境変数を使用します。

---

仕組み

┌────────────────┐  JSON-RPC stdio   ┌────────────────┐  HTTP+Bearer   ┌────────────────┐
│  Claude/Cursor │ ───────────────►  │  InkraMCP      │ ─────────────► │  Inkra.app     │
│  (MCP client)  │ ◄───────────────  │   (this repo)  │ ◄───────────── │  (port 42932)  │
└────────────────┘                   └────────────────┘                └────────────────┘

ブリッジは MCP ツール呼び出しを、Inkra のローカル REST API へのリクエストに変換します。アプリは、ドキュメントの状態（TextKit 2 を使用する NSTextView）、AST ベースの構文ハイライト、KaTeX／Mermaid のライブプレビュー、元に戻す／やり直す、セッションの復元、エクスポートを処理します。

---

環境変数

変数	デフォルト	説明
INKRA_API_PORT	42932	Inkra のローカル HTTP サーバーのポート（Inkra → Settings → API）
INKRA_API_TOKEN	(none)	Inkra → Settings → API で取得するベアラートークン（必須）

---

エラー

拒否された場合はすべて、エージェントが対処できる一文を含む MCP エラー（isError: true）が返されます。

状況	ブリッジからの報告内容
Inkra が起動していない、または API がオフになっている	Inkra は http://localhost:<port> で応答していません。Inkra を開き、「API Enabled」をオンにしてください
トークンがない、または誤っている（HTTP 401）	INKRA_API_TOKEN に Inkra → Settings → API のトークンを設定してください
Inkra Pro を利用していない（HTTP 403 inkra_pro_required）	MCP サーバーは Inkra Pro の一部です。アップグレードできるのはユーザーのみで、アプリまたはストアから行えます
その他の HTTP エラー	ステータスコードと Inkra のエラーテキスト

バージョン 0.2.0 より前は、ブリッジが HTTP ステータスを無視していたため、誤ったトークンや Pro のロックが、成功した呼び出しのように見えていました（「OK、0 文字」）。

---

Inkra について

Inkra はネイティブの macOS Markdown エディターで、Electron アプリではありません。主な機能は次のとおりです。

• ネイティブ — SwiftUI + AppKit による、macOS 本来のパフォーマンス
• ライブプレビュー — KaTeX 数式、Mermaid 図、コードのハイライトを WKWebView でリアルタイムにレンダリング
• 集中モード＋ワイドモード — 邪魔のない執筆環境
• 内蔵 AI アシスタント — Claude、OpenAI、Ollama、または Inkra KI（専用エンドポイントを使用し、API キーは不要）
• エクスポート — レイアウト、数式、図、コードブロックを完全に反映した HTML と PDF
• セッションの復元 — フォルダー、ファイル、カーソル、スクロール位置
• MCP サーバー（このリポジトリ）＋ Swagger UI を備えた REST API — Inkra Pro の一部
• 24 の EU 言語
• Mac App Store と直接ダウンロードで入手可能 — MCP サーバーは直接ダウンロード版に含まれています

→ store.juergenkoller.software で Inkra を入手

---

ライセンス

MIT — LICENSE を参照してください。ブリッジはオープンソースです。Inkra アプリは商用ソフトウェアです。

問題とサポート

• ブリッジの不具合： issue を作成
• アプリのサポート： [email protected]

Juergen Koller Software GmbH が開発しました。