Olaverse Lab

Olaverse MCP 服务

Olaverse Lab 的 API，可作为 Claude、Cursor 和其他 MCP 客户端的 AI Agent 工具。 这些模型体量小、针对特定任务优化，在英语和非洲语言文本上的表现最出色。

工具	功能
extract_document	将文档（文本、JPEG/PNG 照片或扫描件，或 PDF）转换为符合你的模板结构的 JSON，并为每个字段提供经过校准的置信度。长文档会拆分后并行提取，再合并结果。
get_extraction_job	获取仍在处理中的长文档提取结果。
decide	针对消息、工单或记录回答类型化问题（是/否、选项、评分），并提供经过校准的概率。支持 19 种语言。
detect_language	在 608 种语言中识别文本所用的语言（以非洲语言为优先构建，对极短文本也有良好表现）。
restore_diacritics	为 11 种语言补回声调符号、重音符号和阿拉伯语元音符号，包括 Yorùbá、Igbo、Hausa 和 Arabic。
generate_questions	生成搜索式问题，这些问题的答案可在段落中找到，且使用段落本身的语言（支持 25 种语言）。

设置

你需要 Olaverse API 密钥：在 console.olaverselab.com 创建一个（新账户可获得价值 $1 的免费额度）。调用费用按常规价格从你的密钥扣除。

该服务使用 uv 运行（uvx 会下载并运行它）。

Claude Code

claude mcp add olaverse --env OLAVERSE_API_KEY=your-key -- uvx olaverse-mcp

Claude Desktop、Cursor 和其他客户端（客户端 MCP 配置文件中的 mcpServers 块）

{
  "mcpServers": {
    "olaverse": {
      "command": "uvx",
      "args": ["olaverse-mcp"],
      "env": { "OLAVERSE_API_KEY": "your-key" }
    }
  }
}

托管版（无需安装）。 Olaverse 也在 https://mcp.olaverselab.com/mcp 运行此服务（可流式传输的 HTTP）。 每次请求都通过 Authorization: Bearer your-key 发送密钥。托管服务接收的文档须为 text，或以 base64 编码的 image 或 pdf；它不会读取文件或获取 URL。

使用方法

用日常语言提问，Agent 会选择合适的工具：

• “从 ~/Downloads/receipt.jpg 中提取商户、日期、总额和商品明细。”
• “这条客户消息是在要求退款吗？有多紧急？«Ẹ jọ̀ọ́, wọ́n ti yọ owó lẹ́ẹ̀mejì…»”
• “‘Mo fẹ́ lọ sí ọjà’ 是哪种语言？”
• “补回声调符号：se eranko naa si gbo o？”

置信度。 extract_document 会为每个字段返回置信度。该置信度经过校准：对于其适用的文档，置信度为 0.95 及以上的字段，正确率约为 95%。在将其用于自动化处理之前，请先用你自己的文档样本测试阈值。

设置项

变量	默认值
OLAVERSE_API_KEY	必填	你的 API 密钥。
OLAVERSE_API_URL	https://api.olaverselab.com
OLAVERSE_JOB_WAIT	900	长文档提取等待的秒数；超时后会返回作业 ID，供 get_extraction_job 使用。

不会直接读取扫描版 PDF（无文本层）：请将页面作为 JPEG 或 PNG 图像发送。

许可证

Apache-2.0。

mcp-name: io.github.Olaverse-Labs/olaverse-mcp