用途
inkra-mcp 是 Inkra 的官方 Model Context Protocol（MCP）桥接服务器，用于从 Claude、Cursor 或任何 MCP 客户端驱动 macOS 原生 Markdown 编辑器 Inkra。它本身是 stdio→HTTP 桥接：Inkra 应用负责文档状态、撤销栈、语法高亮与渲染，桥接器把 JSON-RPC 通过 stdio 转发到 Inkra 的本地 HTTP MCP 端点。
主要能力
该 MCP 服务器暴露 18 个工具，涵盖文档编辑、大纲导航、文件夹浏览、书签和视图模式等类别。所有工具都作用于 Inkra 应用中当前打开的文档，因此 AI 代理看到的与用户所见完全一致：编辑会实时显示语法高亮与预览，撤销/重做使用应用正常的撤销栈。示例用法包括：让 Claude 打开某个 Markdown 文件、查找包含特定文本的标题并在其后添加复选框并保存；让 Cursor 列出当前文件夹中的所有文件、为某个二级标题加书签、切换到专注模式。
使用方式
前置条件：macOS 14（Sonoma）或更高版本；已安装并运行 Inkra 应用（测试期间免费，可通过 Mac App Store 和直接下载获取）；若从源码构建需要 Swift 5.9+（Xcode 15+）。
安装与配置：可从源码构建，或使用预构建二进制文件。需从 Inkra 的“Settings → API & Integrations”获取 INKRA_TOKEN。在 Cursor 或其他 MCP 客户端中配置方式相同——stdio MCP 服务器，需设置两个环境变量。
适用场景
适合在 macOS 上使用 Inkra 进行 Markdown 写作与文档管理的用户，希望通过 Claude、Cursor 等 AI 客户端直接操作当前文档，例如批量查找并修改标题、管理书签、切换视图模式、浏览文件夹等。
限制
必须安装并运行 Inkra 应用，本仓库仅为桥接器；Inkra 应用为商业软件，桥接器为开源（MIT）。具体工具清单、环境变量名称等细节在资料中未逐一列出，暂未提供。