内容
# Inkra MCP 服务器
[](https://swift.org)
[](https://apple.com/macos)
[](LICENSE)
[](https://modelcontextprotocol.io)
[](https://glama.ai/mcp/servers/juergenkoller-software/inkra-mcp)
**通过 Claude、Cursor 或任何 MCP 客户端驱动原生 macOS Markdown 编辑器。**
这是官方的 [Model Context Protocol](https://modelcontextprotocol.io) 桥接器，适用于 [**Inkra**](https://store.juergenkoller.software.cn/apps/inkra) —— 一款原生 macOS Markdown 编辑器（SwiftUI + AppKit，不是 Electron），具有实时 KaTeX/Mermaid 预览和内置 AI 助手。
> **您需要安装并运行 Inkra 应用程序。** 此 MCP 服务器是一个_stdio→HTTP 桥接器 —— Inkra 拥有文档状态、撤销栈、语法高亮和渲染。在 [store.juergenkoller.software/apps/inkra](https://store.juergenkoller.software.cn/apps/inkra) 获取 Inkra。
---
## 功能
> “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 前置元数据解析器） |
| **视图** | `theme_set`（标准/棕褐色/夜间），`view_mode_set`（专注/宽） |
| **状态** | `window_info` |
每个工具都对 Inkra 应用程序中**当前打开的文档**进行操作 —— 因此 AI 代理看到的内容与您看到的内容完全相同，编辑实时显示，带有语法高亮和预览，撤销/重做在应用程序的正常撤销栈中生效。
---
## 安装
### 先决条件
1. **macOS 14 (Sonoma) 或更高版本**
2. **已安装并运行 Inkra 应用程序** —— [在此处获取](https://store.juergenkoller.software.cn/apps/inkra)（测试期间免费，可在 Mac 应用商店和直接下载）
3. **Swift 5.9+**（Xcode 15+），如果从源代码构建
### 从源代码构建
```bash
git clone https://github.com/juergenkoller-software/inkra-mcp.git
cd inkra-mcp
swift build -c release
# 二进制文件：.build/release/InkraMCP
```
### 预构建的二进制文件
请参阅 [发行版](https://github.com/juergenkoller-software/inkra-mcp/releases)。
---
## 配置
### Claude 桌面
```json
{
"mcpServers": {
"inkra": {
"command": "/path/to/InkraMCP",
"env": {
"INKRA_PORT": "22300",
"INKRA_TOKEN": "your-token-here"
}
}
}
}
```
从 **Inkra → 设置 → API & 集成** 获取 `INKRA_TOKEN`。
### Claude 代码
```bash
claude mcp add inkra /path/to/InkraMCP \
--env INKRA_PORT=22300 \
--env INKRA_TOKEN=your-token-here
```
### Cursor / 其他 MCP 客户端
相同的模式 —— stdio MCP 服务器，两个环境变量。
---
## 工作原理
```
┌────────────────┐ JSON-RPC stdio ┌────────────────┐ HTTP+Bearer ┌────────────────┐
│ Claude/Cursor │ ───────────────► │ InkraMCP │ ─────────────► │ Inkra.app │
│ (MCP 客户端) │ ◄─────────────── │ （此仓库） │ ◄───────────── │ （端口 22300） │
└────────────────┘ └────────────────┘ └────────────────┘
```
桥接器通过 stdio 将 JSON-RPC 转发到 Inkra 的本地 HTTP MCP 端点。应用程序处理文档状态（带有 TextKit 2 的 NSTextView）、基于 AST 的语法高亮、KaTeX/Mermaid 实时预览、撤销/重做、会话恢复和导出。
---
## 环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
| `INKRA_PORT` | `22300` | Inkra 的本地 HTTP 服务器端口 |
| `INKRA_TOKEN` | _(无)_ | Inkra 设置中的 Bearer Token（必需） |
---
## 关于 Inkra
Inkra 是一款原生 macOS Markdown 编辑器 —— **不是** Electron 应用程序。亮点：
- **原生** —— SwiftUI + AppKit，真正的 macOS 性能
- **实时预览** —— KaTeX 公式、Mermaid 图表、代码高亮实时渲染 via WKWebView
- **专注模式 + 宽模式** —— 无干扰写作
- **内置 AI 助手** —— Claude、OpenAI、Ollama 或 Inkra KI（专用端点，无需 API 密钥）
- **导出** —— HTML 和 PDF，带有完整布局、公式、图表、代码块
- **会话恢复** —— 文件夹、文件、光标、滚动位置
- **MCP 服务器**（此仓库）+ 带有 Swagger UI 的 REST API
- **23 种欧盟语言本地化**
- **在 Mac 应用商店 + 直接下载**
→ **[在 store.juergenkoller.software 获取 Inkra](https://store.juergenkoller.software.cn/apps/inkra)**
---
## 许可证
MIT —— 请参阅 [LICENSE](LICENSE)。桥接器开源；Inkra 应用程序是商业软件。
## 问题和支持
- **桥接器错误：** [打开问题](https://github.com/juergenkoller-software/inkra-mcp/issues)
- **应用程序支持：** [support@juergenkoller.software](mailto:support@juergenkoller.software)
由 [Juergen Koller 软件有限公司](https://juergenkoller.software) 构建。
