# AILANG Parse MCP server

> Extracts structured content from Office and PDF documents into JSON and markdown and generates documents from markdown.

- Repository: https://github.com/sunholo-data/ailang-parse
- Page: https://hostedmcp.org/servers/sunholo-data/ailang-parse
- Transport: stdio, remote
- Stars: 0
- License: Apache-2.0
- Latest version: 0.14.1

## Install

### Claude Code

```sh
claude mcp add --env 'DOCPARSE_API_KEY=<YOUR_DOCPARSE_API_KEY>' ailang-parse -- npx -y @ailang/parse
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "ailang-parse": {
      "command": "npx",
      "args": [
        "-y",
        "@ailang/parse"
      ],
      "env": {
        "DOCPARSE_API_KEY": "<YOUR_DOCPARSE_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "ailang-parse": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ailang/parse"
      ],
      "env": {
        "DOCPARSE_API_KEY": "<YOUR_DOCPARSE_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"ailang-parse","type":"stdio","command":"npx","args":["-y","@ailang/parse"],"env":{"DOCPARSE_API_KEY":"<YOUR_DOCPARSE_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "ailang-parse": {
      "command": "npx",
      "args": [
        "-y",
        "@ailang/parse"
      ],
      "env": {
        "DOCPARSE_API_KEY": "<YOUR_DOCPARSE_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add ailang-parse --env 'DOCPARSE_API_KEY=<YOUR_DOCPARSE_API_KEY>' --env 'DOCPARSE_API_KEY=<YOUR_DOCPARSE_API_KEY>' -- npx -y @ailang/parse
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.ailang-parse]
command = "npx"
args = ["-y", "@ailang/parse"]

[mcp_servers.ailang-parse.env]
DOCPARSE_API_KEY = "<YOUR_DOCPARSE_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'DOCPARSE_API_KEY=<YOUR_DOCPARSE_API_KEY>' -e 'DOCPARSE_API_KEY=<YOUR_DOCPARSE_API_KEY>' ailang-parse npx -- -y @ailang/parse
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "ailang-parse": {
      "command": "npx",
      "args": [
        "-y",
        "@ailang/parse"
      ],
      "env": {
        "DOCPARSE_API_KEY": "<YOUR_DOCPARSE_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `DOCPARSE_API_KEY` | no | yes | AILANG Parse API key (dp_...). Optional — the bridge auto-loads keys saved at ~/.config/ailang-parse/credentials.json. Get one from https://www.sunholo.com/ailang-parse/ |
| `DOCPARSE_API_KEY` | no | yes | AILANG Parse API key (dp_...). Optional — the bridge auto-loads keys saved at ~/.config/ailang-parse/credentials.json. Get one from https://www.sunholo.com/ailang-parse/ |
| `AILANG_PARSE_MCP_URL` | no | no | Override the hosted MCP endpoint. Defaults to https://docparse.ailang.sunholo.com/mcp/ |
| `AILANG_PARSE_MCP_URL` | no | no | Override the hosted MCP endpoint. Defaults to https://docparse.ailang.sunholo.com/mcp/ |

## FAQ

### What formats can AILANG Parse extract content from?

It supports 16 formats including DOCX, PPTX, XLSX, ODT, ODP, ODS, HTML, Markdown, CSV, EPUB, EML, MBOX, TEX, RTF, PDF, and images like JPG/PNG.

### Can I generate documents using AILANG Parse?

Yes, you can write documents in Markdown and convert them into 9 different formats including DOCX, PPTX, XLSX, and HTML.

### How does the parser handle scanned PDFs?

If the default backend finds no text layer, it automatically escalates to local docling OCR for scanned or image-only PDFs.

### Does parsing require an internet connection or AI?

Office formats use deterministic XML parsing that requires no AI or cloud, providing instant local results.
