somark MCP

SoMark MCP服务器

英语 | 中文

A. 模型上下文协议（MCP） 服务器 SoMark的文档解析API。它将PDF和图像文件解析为Markdown、JSON格式，精度很高。

快速开始

1.获取API密钥 → somark.tech/workbench/apikey

2.将以下内容添加到MCP客户端配置中 （克劳德桌面、VS代码、光标等）：

{
    "mcpServers": {
        "somark": {
            "command": "npx",
            "args": ["-y", "somark-mcp"],
            "env": {
                "SOMARK_API_KEY": "your-api-key-here"
            }
        }
    }
}

3.完成！ 让你的AI助手解析任何PDF或图像文件。

可用工具

check_api_key

检查SoMark API密钥是否已配置并准备好使用。

set_api_key

在运行时设置或更新SoMark API密钥（在未设置环境变量时很有用）。

extract_document

将PDF或图像文件（PNG、JPG、JPEG、BMP、TIFF、JP2、DIB、PPM、PGM、PBM、GIF、HEIC、HEIF、WebP、XPM、TGA、DDS、XBM）解析为 markdown, json 格式。

element_formats 领域：

• image: "url" | "base64" | "none"，默认值 url
• formula: "latex" | "mathml" | "ascii"，默认值 latex
• table: "html" | "markdown" | "image"，默认值 html
• cs: "image"，默认值 image

feature_config 领域：

• enable_text_cross_page：boolean，默认值 false
• enable_table_cross_page：boolean，默认值 false
• enable_title_level_recognition：boolean，默认值 false
• enable_inline_image：boolean，默认值 true
• enable_table_image：boolean，默认值 true
• enable_image_understanding：boolean，默认值 true
• keep_header_footer：boolean，默认值 false

支持的文件格式：

• PDF(.pdf)
• PNG(.png)
• JPEG(.jpg, .jpeg)
• BMP(.bmp, .dib)
• TIFF(.tiff, .tif)
• JPEG 2000(.jp2)
• 便携式Pixmap(.ppm)
• 便携式灰色地图(.pgm)
• 便携式位图(.pbm)
• GIF(.gif)
• HEIC(.heic)
• 嘿(.heif)
• WebP(.webp)
• X像素地图(.xpm)
• 塔尔加(.tga)
• DirectDraw表面(.dds)
• X位图(.xbm)

示例用法：

// Parse a PDF to Markdown
{
  "file_path": "/path/to/document.pdf",
  "output_formats": ["markdown"]
}

// Parse an image to JSON
{
  "file_path": "/path/to/image.png",
  "output_formats": ["json"]
}

发展

pnpm install          # Install dependencies
pnpm build            # Build the project
pnpm exec tsc --noEmit  # Type check

测试

pnpm test             # Full MCP server test
pnpm test:api         # API connection test

故障排除

许可证

国际学生委员会