Nougat MCP

牛轧糖MCP

](https://pypi.org/project/nougat-mcp/) ](https://pypi.org/project/nougat-mcp/)  

nougat-mcp 是一个模型上下文协议（MCP）服务器，用于使用Meta的Nougat对科学PDF进行高保真OCR。

它专为需要比传统OCR更好地保留方程、表格和结构的代理工作流而设计。

为什么选择此服务器

• 为纸张、公式和密集布局量身定制的科学OCR质量。
• 用于Codex、Claude、Cursor、Antigravity和其他客户端的MCP本地接口。
• 输出格式控制：

- mmd：原始Nougat/Mathpix样式输出。 - md：渲染器友好的转换（数学分隔符和KaTeX兼容性修复）。

• 设置文件支持，因此代理可以读取共享的默认格式策略。

安装

从PyPI安装：

uv pip install nougat-mcp

此软件包安装 nougat-ocr 并引脚已知的敏感稳定性依赖关系。

工具

parse_research_paper

论据：

• file_path （string）：本地PDF的绝对路径。
• output_format （字符串，可选）：

- default （默认）：使用服务器设置。 - mmd：牛轧糖的原始产量。 - md：转换为对markdown友好的输出。

退货：

• OCR结果为请求格式的单个文本字符串。

get_output_settings

返回解析的服务器输出设置，包括从何处加载设置。

输出转换(mmd -> md)

当 output_format="md"，服务器应用兼容性转换：

• \[ ... \] -> $$ ... $$
• \( ... \) -> $ ... $
• \tag{...} ->可见方程式标签 \qquad\text{(...)}
• KaTeX分隔符规范化，例如：

- \bigl{\|} ... \bigr{\|} -> \bigl\| ... \bigr\|

这避免了在不完全兼容MathJax的markdown环境中常见的渲染器解析错误。

服务器设置

设置按以下顺序读取：

1. NOUGAT_MCP_SETTINGS （如果设置）
2. ./settings.json （当前工作目录）

示例 settings.json:

{
  "nougat_mcp": {
    "default_output_format": "md",
    "md_rewrite_tags": true,
    "md_fix_sized_delimiters": true
  }
}

代理配置

Codex CLI

增添 ~/.codex/config.toml:

[mcp_servers.nougat]
command = "uvx"
args = ["nougat-mcp"]
enabled = true

[mcp_servers.nougat.env]
NOUGAT_MCP_SETTINGS = "/absolute/path/to/settings.json"

克劳德桌面

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "nougat": {
      "command": "uvx",
      "args": ["nougat-mcp"],
      "env": {
        "NOUGAT_MCP_SETTINGS": "/absolute/path/to/settings.json"
      }
    }
  }
}

反重力/双子桌面

增添 ~/.gemini/settings.json:

{
  "mcpServers": {
    "nougat": {
      "type": "stdio",
      "command": "uvx",
      "args": ["nougat-mcp"],
      "env": {
        "NOUGAT_MCP_SETTINGS": "/absolute/path/to/settings.json"
      }
    }
  }
}

光标

在光标MCP设置中，添加：

{
  "mcpServers": {
    "nougat": {
      "command": "uvx",
      "args": ["nougat-mcp"],
      "env": {
        "NOUGAT_MCP_SETTINGS": "/absolute/path/to/settings.json"
      }
    }
  }
}

注：光标MCP配置位置可能因版本/平台而异；使用MCP设置UI或当前的JSON设置文件。

展示（真实页面示例）

第5页的真实摘录 src/2405.08770v1.pdf 包括：

• 输入PDF页面： 展示柜/2405.08770v1_page5.pdf
• 原始 mmd 输出： 展示柜/2405.08770v1_page5.mmd
• 已转换 md 输出： 展示柜/2405.08770v1_page5.md

快速比较：

# mmd
\[DV=V_{x}. \tag{3.2}\]

# md
$$
DV=V_{x}. \qquad\text{(3.2)}
$$

业绩说明

• 第一次运行可能会下载模型权重（~1.4 GB）。
• CPU推理比GPU推理慢得多。
• 尽可能使用页面子集以减少运行时间。

兼容性引脚

为了使Nougat在各种环境中保持稳定，该包固定了敏感的依赖范围：

• `transformers>=4.35,=1.3,
• 纸张：

许可证

GNU通用公共许可证v3.0(LICENSE).