Deno MCP Pandoc

MCP文档知识

提供方 tlockney

文档知识 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaude

基于Deno/TypeScript和Pandoc的多格式文档双向转换服务,支持10种文件格式转换,适用于桌面和Web应用。

一句话选型结论

按资料字段整理

Deno MCP Pandoc 属于文档知识类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 1 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量1暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

文档转换TypeScript本地部署多格式支持Pandoc集成Deno应用TypeScript开发

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 1 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 1 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Deno MCP Pandoc当前 1 未标注 未标注 无 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方tlockney上游标注的维护方 tlockney
分类文档知识本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.1 KB
来自项目仓库与上游目录的原文,未做删改

Deno MCP-Pandoc

一个Deno/TypeScript的实现 MCP(最小成本路径/最小代价路径) 文档服务器
使用 Pandoc 进行转换。

> 归属(或“注明来源”)这个项目是一个受启发而做的Deno/TypeScript移植版本
> MCP-Pandoc 由
> 该项目的基础与设计。

特点/功能

  • 双传输模式Stdio(用于Claude桌面版)和HTTP/SSE(用于Web应用程序)
  • 独立二进制文件编译成一个单独的可执行文件,使用 deno compile
  • 10种格式支持Markdown、HTML、txt(纯文本)、ipynb、ODT、PDF、docx、rst、LaTeX、epub
  • 双向转换在所有格式之间进行转换(输入格式不包括PDF)
  • 高级功能:
  • 通过参考文档实现DOCX样式
  • 用于配置的YAML默认文件
  • Pandoc过滤器支持
  • 基于内容或文件的转换
  • 自动过滤路径解析

先决条件

  • Deno 版本1.40或更高版本
  • 对于PDF输出:XeLaTeX(包含在 TeX Live)

安装

使用 Deno```bash

Clone the repository

git clone https://github.com/yourusername/deno-mcp-pandoc.git
cd deno-mcp-pandoc

Run directly with Deno

deno task start # Stdio mode (default)
deno task start:http # HTTP mode

Or install globally

deno install --allow-all -n mcp-pandoc src/main.ts


### 编译为独立二进制文件```bash
# Compile to a single executable
deno task compile

# The binary will be created at bin/mcp-pandoc
./bin/mcp-pandoc              # Stdio mode (default)
./bin/mcp-pandoc --http       # HTTP mode

# Optionally, copy to a directory in your PATH
cp bin/mcp-pandoc /usr/local/bin/

验证Pandoc的安装```bash

pandoc --version


如果未找到 Pandoc,请进行安装:

- **macOS(发音为 /ˈmækɒs/,中文常音译为“麦奥斯”或直接使用原名)**: `brew install pandoc`

## 使用方法

该服务器通过一个统一入口支持两种传输模式:

### 1. 标准I/O传输(用于Claude桌面版)

在您的Claude桌面配置文件中添加:

**macOS(苹果电脑操作系统)**: `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows**:
`%APPDATA%\Claude\claude_desktop_config.json`

使用Deno:```json
{
"mcpServers": {
"pandoc": {
"command": "deno",
"args": [
"run",
"--allow-all",
"/absolute/path/to/deno-mcp-pandoc/src/main.ts"
]
}
}
}

或者使用编译后的二进制文件:```json
{
"mcpServers": {
"pandoc": {
"command": "/absolute/path/to/bin/mcp-pandoc"
}
}
}


更改后重启 Claude Desktop。

### 2. HTTP传输(用于Web应用程序)

启动HTTP服务器:```bash
# Using Deno tasks
deno task start:http

# Or run directly
deno run --allow-all src/main.ts --http

# Or using the compiled binary
./bin/mcp-pandoc --http

# Specify custom port and host via environment variables
PORT=8080 HOST=0.0.0.0 deno task start:http

服务器提供以下端点:

  • 健康检查: GET http://localhost:3000/health
  • SSE 终点(或:SSE 端点): GET http://localhost:3000/sse (MCP的服务器发送事件)
  • MCP 终端节点: GET http://localhost:3000/mcp (MCP消息处理)

配置您的Web应用程序以连接到用于MCP通信的SSE终端。

MCP 工具:转换内容

该服务器提供了一个强大的单一体工具用于文档转换。

参数

  • 内容 (字符串,可选):要转换的内容(使用此内容或输入文件)
  • 输入文件 (字符串,可选):输入文件的路径(使用此路径或文件内容)
  • 输入格式 (字符串,默认值: "markdown"):输入格式
  • 输出格式 (字符串,默认:"markdown"):输出格式
  • 输出文件 (字符串,可选):输出文件的路径(对于PDF、DOCX、EPUB、ODT格式为必填)
  • 参考文档 (字符串,可选):用于样式设置的参考文档路径
  • 默认文件 (字符串,可选):指向 Pandoc 默认设置 YAML 文件的路径
  • 过滤器 (数组,可选):Pandoc 过滤器名称或路径的列表

支持的格式

格式 输入 输出 扩展名 备注
Markdown √ √ .md GitHub Flavored Markdown(GitHub风味Markdown)
HTML √ √ .html HTML5
纯文本 ✓ ✓ .txt 纯文本
Jupyter √ √ .ipynb Jupyter 笔记本文件
ODT ✓ ✓ .odt OpenDocument 文本文件
PDF 格式 不支持 支持 .pdf 需要输出文件
DOCX ✓ ✓ .docx Microsoft Word
reStructuredText ✓ ✓ .rst reStructuredText(重新结构化文本)
EPUB ✓ ✓ .epub EPUB 电子书

示例

将Markdown转换为HTML```

User: "Convert this markdown to HTML: # Hello World\n\nThis is bold text."

Claude uses the convert-contents tool:
{
"contents": "# Hello World\n\nThis is bold text.",
"input_format": "markdown",
"output_format": "html"
}


### 将文件转换为PDF```
User: "Convert my document.md to a PDF"

Claude uses the convert-contents tool:
{
"input_file": "document.md",
"output_file": "document.pdf",
"input_format": "markdown",
"output_format": "pdf"
}

使用默认文件```

User: "Convert my essay to PDF using academic formatting"

Claude uses the convert-contents tool:
{
"input_file": "essay.md",
"output_file": "essay.pdf",
"input_format": "markdown",
"output_format": "pdf",
"defaults_file": "examples/defaults/academic-pdf.yaml"
}


### 使用参考文档为DOCX设置样式```
User: "Convert this to DOCX using my company template"

Claude uses the convert-contents tool:
{
"input_file": "report.md",
"output_file": "report.docx",
"input_format": "markdown",
"output_format": "docx",
"reference_doc": "templates/company-template.docx"
}

YAML 默认文件

默认配置文件允许您以YAML格式配置Pandoc选项。

示例(examples/defaults/academic-pdf.yaml):```yaml
pdf-engine: xelatex
variables:
geometry: margin=1in
fontsize: 12pt
toc: true
number-sections: true


见 `examples/defaults/` 目录中包含更多示例。

## Pandoc 过滤器

过滤器允许您转换文档的抽象语法树(AST)。将过滤器置于 `~/.pandoc/filters/` 或指定
完整路径。```
{
"contents": "...",
"filters": ["my-filter.lua", "/path/to/another-filter.py"]
}

服务器按以下顺序自动解析过滤器路径:

  1. 绝对路径
  2. 相对于当前工作目录
  3. 相对于默认文件目录
  4. ~/.pandoc/filters/

发展

运行服务器```bash

Stdio server (for Claude Desktop)

deno task start

HTTP server (for web applications)

deno task start:http

Development mode with file watching

deno task dev # stdio server
deno task dev:http # HTTP server


### 建筑;大楼```bash
# Compile to standalone binary
deno task compile

# The binary will be created at bin/mcp-pandoc
# Run it with:
./bin/mcp-pandoc              # stdio mode
./bin/mcp-pandoc --http       # HTTP mode

运行测试```bash

Run all tests

deno task test

Run specific test file

deno task test tests/unit/converter_test.ts

Run with coverage

deno task coverage


### 代码质量```bash
# Format code
deno task fmt

# Lint code
deno task lint

# Type check
deno task check

项目结构```

deno-mcp-pandoc/
├── src/
│ ├── main.ts # Unified entry point with CLI arg parsing
│ ├── mcp.ts # Shared MCP server creation logic
│ ├── converter.ts # Pandoc conversion logic
│ ├── validation.ts # Input validation
│ ├── filters.ts # Filter path resolution
│ ├── defaults.ts # YAML defaults handling
│ └── errors.ts # Custom error types
├── bin/
│ └── mcp-pandoc # Compiled binary (created by deno task compile)
├── tests/
│ ├── unit/ # Unit tests
│ ├── integration/ # Integration tests (if any)
│ └── fixtures/ # Test fixtures
├── examples/
│ └── defaults/ # Example YAML configurations
├── deno.json # Deno configuration
└── README.md # This file


## 故障排除

### 未找到 Pandoc

**错误**: `PandocNotFoundError: Pandoc not found`

**解决方案**安装 Pandoc 并确保它已添加到你的 PATH 中,或者设置 `PANDOC_PATH` 环境
变量:```bash
export PANDOC_PATH=/path/to/pandoc

PDF转换失败

错误: xelatex not found

解决方案安装一个LaTeX发行版(如TeX Live、MiKTeX等):

  • macOS: brew install --cask mactex
  • Ubuntu/Debian(这两个都是Linux发行版): sudo apt install texlive-xetex
  • Windows安装 MiKTeX

未找到过滤器

错误: FilterNotFoundError: Filter "my-filter.lua" not found

解决方案:

  1. 验证过滤文件是否存在
  2. 检查文件权限(在类Unix系统上应可执行)
  3. 使用过滤器的完整路径
  4. 将过滤器放置在 ~/.pandoc/filters/

无效的默认设置文件

错误: DefaultsFileError: Failed to parse YAML

解决方案:

  1. 使用YAML验证器验证YAML语法
  2. 确保文件包含一个YAML对象(而非列表或基本类型)
  3. 不要同时指定两者 from 和 to 在默认文件中(请使用参数代替)

贡献;助力

欢迎投稿!请确保:

  1. 所有测试均通过: deno task test
  2. 代码已格式化: deno task fmt
  3. 代码通过了语法检查: deno task lint
  4. 类型检查成功: deno task check
  5. 测试覆盖率保持在90%以上

发布流程

使用自动化发布流程。

许可证

MIT 许可证 - 详见 LICENSE 文件

致谢

  • 建立在……之上 Pandoc(潘多克) 由约翰·麦克法兰撰写
  • 使用 模型上下文协议 由Anthropic开发
  • 受启发并移植自 mcp-pandoc(可译为“MCP-Pandoc”,其中MCP可能代表某个特定项目或组织的缩写,Pandoc是一个文档转换工具) 由

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Deno MCP Pandoc 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Deno MCP Pandoc 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Deno MCP Pandoc 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Deno MCP Pandoc 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Deno MCP Pandoc 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Deno MCP Pandoc 能提供哪些能力?

资料显示约 1 个工具;能力标签包括 文档转换、多格式支持、TypeScript、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。