内容
us-mcp-server](https://github.com/transkribus-m/actions/workflows/test.yml/badge.svggithub.com/lazyantsribus-mcp-server/actions.yml)
Transkribus 的 MCP 服务器。 通过模型管理集合、文档、HTOCR 识别、模型等301 个工具**，涵 个资源域，拥有 8 个入口点，您可以选择适合以满足 MCP 客户端的。
> **API 范围服务器涵盖 **旧kribus TrpServer**。 新的 **Processing2**（OIDC processing/v2`，.readcoop.eu`）被故意排除在范围之外。
## 安装
```bash
npm install -g @lazyants/transkribus-mcp-server
```
或直接运行：
```bash
npx @lazyants/transkribus-mcp-server
```
## 配置
Transkribus 使用基于会话的身份验证。您可以通过两种方式进行身份验证：
### 选项 1：用户名 + 密码（自动登录）
```bash
export TRANSKR_USER=your-email
export TRANSKR_PASSWORD=your-password
将自动登录并管理会话。
### 选项 直接会话 ID
```bash TRANSKRIBUS_SESSION_ID=your-session-id
```
如果您来自 Transkribus 平台，请使用此选项。
## 入口点
| 命令 | | 工具 |
|---|---| `transkribus-m` | 所有 22 个 301 |
| `transus-mcp-collections`份验证，集合（文档/页面/用户/编辑/声明/统计/活动/标签） | | `transkribus-mcp-admin` | 身份管理，积分，上传，文件，系统，根目录63 |
| `transkribus-mcp-transcription` |，识别，布局PyLaia，P2，DU | 48 |
transkribus-mcp | 身份验证，用户包，电子学习 | | `transkribus-models` | 身份验证 | 27 |
| `ribus-mcp-j | 身份验证，作业 | 19 |
| `ribus-mcp-search 身份验证，搜索， | 17 |
使用分减少上下文大小 — 只您需要的分服务器。
##
添加到 `~/.claude/settings.json`：
```{
"mcpServers "transkribus "command": "n "args": ["", "@lazyants/transkribus-mcp-server"],
" {
"TRANSKR_USER": "your-email@example "TRANSKRIBUS "your-password"
}
}
}
```
或服务器（选择您需要的）：
```json
{
"mcpServers": {
kribus-collections "command": "n "args": ["- "-p", "@lazyantsribus-mcp-servertranskribus-mlections"],
"env": {
"TRANSKRIBUS_USER":-email@example.com",
TRANSKRIBUS_PASSWORD":-password"
}
},
"transkribus-trans {
"command": "",
"args": ["-y", "-p", "@/transkribus-m", "transkribus-transcription"],
"env "TRANSKRIB": "your-email@example.com "TRANSKRIBUS_PASSWORD": "your-password"
}
}
}
```
##桌面
添加到 `claude_des.json`：
{
"mcp {
"transkribus": {
"command": "npx",
"args": ["-y", "@lazyantsribus-mcp-server "env": {
"IBUS_USER": "@example.com",
"TRANSKRIBUS_PASSWORD": "your-password"
}
}
}
}
```
## 安全
- **永远不要将您的凭证** 提交到版本控制中
- 使用环境变量或 `.env` 文件（通过 `.gitignore` 排除）
- 会话 ID 过期 — 优先使用用户名/密码进行长期设置
## 免责声明
这是 Transkribus 的非官方 MCP 服务器。作者与 READ-COOP SCE 无关。使用风险自负。
## 发布
发布 GitHub 发布事件进行。维护者流程：. 在 `package 和 `server.json增加版本号（`npm-versions` 强制.json#/version` 和 `server.json#/packages[0].version` 之间的对齐）。
2. 更新 `CHANGELOG.md`。
3. 提交，然后 `gh release create vX.Y.Z --notes-from-tag`（或内联编写发布说明）。
4. 工作流自动运行：它发布 `npm` 并带有出处，轮询注册表直到 tarball 可用，然后通过 `mcp-publisher` 将匹配的 `server.json` 推送到 MCP 注册表。
工作流如果版本已经在 npm 上，则会干净地跳过 `npm publish`（手动部分发布的版本的切断保护）。
### npm 身份验证
发布使用 **npm Trusted Publishing**：工作流的 GitHub OIDC token（`id-token: write`）兑换为一次性发布 token。存储库中不需要 `N` 机密。
绑定在 npm Web UI 中配置（ → 受信任的发布者）：提供程序 `GitHub Actions组织 `lazyants`，存储库 `transkribcp-server`，工作流 `publish-registry.yml`。
许可证
[FSL-1-MIT](LICENSE 请参阅 [LICENSE](LICENSE) 以获取完整条款。.x` 版本仍受许可。
