AILANG Parse

Parse, convert and create Office and PDF documents. OAuth at /mcp/connect/, API key at /mcp/.

我該用這個嗎

品質與安全性

A
說明品質
100%
結構描述完整度
72%
命名品質
88%
汙染風險
100%
權限相符程度
100%
協定合規性
100%

根據工具定義與協定合規性的自動化分析。

上下文成本

~3,113Token(工具定義)
~930 B典型回應大小
顯著的注意力影響(128k 上下文的 2.43%)

這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。

安裝

一鍵安裝

將以下內容加入你的 `claude_desktop_config.json` 檔案:

{
  "mcpServers": {
    "parse": {
      "command": "npx",
      "args": [
        "@ailang/parse"
      ]
    }
  }
}

可執行的套件

npm@ailang/parse0.14.0stdio
pypiailang-parse0.14.0stdio

遠端端點

https://docparse.ailang.sunholo.com/mcp/streamable-http
https://docparse.ailang.sunholo.com/mcp/connect/streamable-http

它能做什麼

工具清單

工具(10)

🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟡createUpload(count, filename, mimeType)

Get one-time upload links for files in your sandbox or workspace, when you can run shell commands with network access (Claude Code, Codex, a code sandbox). One token PER FILE: a token uploads exactly one file. For several files set count (1..20) to get that many descriptors in one call. Each descriptor has a curl line: run it where the file is (replace <path>); it prints a receipt with a fileRef. Then call mcpParse, mcpConvert or editDocument with that fileRef. Tokens work once, for 10 minutes. If curl fails with a network error, or the user wants to pick a file, call uploadDocument instead, or ask for an https:// link. Never parse the file yourself.

輸入結構描述

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer"
    },
    "filename": {
      "type": "string"
    },
    "mimeType": {
      "type": "string"
    }
  },
  "required": []
}
🟢editDocument(content, contentEncoding, deltas, file, fileRef, ...)

Edit a document: parse it, apply a JSON array of edit deltas, and return the modified blocks (same shape as mcpParse with outputFormat "blocks"). deltas "" or "[]" returns the document unchanged. Office formats only: docx, pptx, xlsx, odt, odp, ods. Give the document ONE way: fileRef: a file the user uploaded (mcp-file://docparse/file_...). file: in ChatGPT, the file the user attached (ChatGPT fills it in). content + filename: the file base64-encoded, contentEncoding="base64", e.g. filename "contract.docx". filepath: an https:// URL of a publicly reachable document, or a sample id from mcpFormats such as "sample_docx_formatting". To get a file back, pass the edited blocks' Markdown to mcpConvert. Which way to send a file: a file in your sandbox or workspace: call createUpload (one token PER FILE; set count for several) and run its curl line, then pass the fileRef here. curl fails with a network error, or the user wants to pick a file: call uploadDocument (the user chooses it in the AILANG Parse card). The card parses the file; it does not convert or edit it. a public https:// link; short text as content. In ChatGPT, file. Never parse the file yourself (your own script, or your own reading of it) and present that as this tool's result: if the file cannot be sent, tell the user.

輸入結構描述

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string"
    },
    "contentEncoding": {
      "type": "string"
    },
    "deltas": {
      "type": "string"
    },
    "file": {
      "additionalProperties": false,
      "properties": {
        "download_url": {
          "type": "string"
        },
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        }
      },
      "required": [
        "download_url",
        "file_id"
      ],
      "type": "object"
    },
    "fileRef": {
      "type": "string"
    },
    "filename": {
      "type": "string"
    },
    "filepath": {
      "type": "string"
    }
  },
  "required": []
}
🟡mcpAccount(action)

Your AILANG Parse account: plan, monthly usage and limits, your keys, and whether request history is kept. Actions: "status" (default) → plan, usage this month and remaining allowance "keys" → your keys with per-key usage ("usage" is an alias) "history" → whether request history (parsed output kept for replay) is on for your account "history_on" / "history_off" → change it for the account and all its keys

輸入結構描述

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string"
    }
  },
  "required": []
}
🟢mcpConvert(content, contentEncoding, file, fileRef, filename, ...)

Create a document in another format: docx, pptx, xlsx, odt, odp, ods, html, md or qmd. To write a new document, write Markdown and send it as content with filename "notes.md" (in pptx the content is laid out on slides and continues onto new slides when it does not fit). To convert an existing document, give it ONE way: fileRef: a file the user uploaded (mcp-file://docparse/file_...). file: in ChatGPT, the file the user attached (ChatGPT fills it in). content + filename: the document itself; binary files base64-encoded with contentEncoding="base64", text as plain text. input: an https:// URL of a publicly reachable document, or a sample id from mcpFormats. Which way to send a file: a file in your sandbox or workspace: call createUpload (one token PER FILE; set count for several) and run its curl line, then pass the fileRef here. curl fails with a network error, or the user wants to pick a file: call uploadDocument (the user chooses it in the AILANG Parse card). The card parses the file; it does not convert or edit it. a public https:// link; short text as content. In ChatGPT, file. Never parse the file yourself (your own script, or your own reading of it) and present that as this tool's result: if the file cannot be sent, tell the user. The result carries download_url, a link to the generated file valid for one hour: give it to the user. It also carries the file as base64 in content (encoding "base64"; text formats come back as utf8). Leave outputPath empty: the server cannot write to your filesystem.

輸入結構描述

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string"
    },
    "contentEncoding": {
      "type": "string"
    },
    "file": {
      "additionalProperties": false,
      "properties": {
        "download_url": {
          "type": "string"
        },
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        }
      },
      "required": [
        "download_url",
        "file_id"
      ],
      "type": "object"
    },
    "fileRef": {
      "type": "string"
    },
    "filename": {
      "type": "string"
    },
    "input": {
      "type": "string"
    },
    "outputFormat": {
      "type": "string"
    },
    "outputPath": {
      "type": "string"
    }
  },
  "required": [
    "outputFormat"
  ]
}
🟢mcpEstimate(filepath, outputFormat)

Estimate how long parsing takes and whether it uses AI, before you parse. filepath: a sample id from mcpFormats, such as "sample_pdf" or "sample_docx_tables". The estimate depends only on the format. No sign-in needed.

輸入結構描述

{
  "type": "object",
  "properties": {
    "filepath": {
      "type": "string"
    },
    "outputFormat": {
      "type": "string"
    }
  },
  "required": [
    "filepath",
    "outputFormat"
  ]
}
🟢mcpFormats

What AILANG Parse can read and write, how to send it a document, and the sample documents you can try without one. No sign-in needed.

輸入結構描述

{
  "type": "object",
  "properties": {},
  "required": []
}
🟢mcpParse(content, contentEncoding, cursor, file, fileRef, ...)

Parse a document into structured blocks, Markdown, HTML or A2UI, or a short summary of it. Give the document ONE way: fileRef: an uploaded file (mcp-file://docparse/file_...). The same user can use it again for 30 minutes after the first use (more parts, another format), then it is deleted. file: in ChatGPT, the file the user attached (ChatGPT fills it in). filepath: an https:// URL of a publicly reachable document, or a sample id from mcpFormats such as "sample_docx_formatting". content + filename: short text only (Markdown, HTML, CSV); the filename's extension picks the parser. outputFormat: blocks (default), markdown, html, a2ui, or summary (counts, the first 50 headings, warnings: a few KB). Look with summary first when a document may be large. Large documents come in parts: when the result has page.nextCursor, call mcpParse again with the same fileRef/filepath and cursor=<nextCursor> for the next part; read every part before answering about the whole document. maxChars sets the part size in characters (default 80000, 2000..120000). pdfBackend: leave empty for PDFs with a text layer. Set "ai" when the result is PDF_TEXT_LAYER_SPARSE (a scanned PDF): each page is read by an AI model, about 5 seconds a page, and the call counts as an AI request. Pass the same pdfBackend with every cursor call. Which way to send a file: a file in your sandbox or workspace: call createUpload (one token PER FILE; set count for several) and run its curl line, then call this tool with the fileRef the upload prints. curl fails with a network error, or the user wants to pick a file: call uploadDocument; the user chooses it in the AILANG Parse card, which uploads it and gives you its fileRef. a public https:// link: filepath. Short text: content. Never parse the file yourself (your own script, or your own reading of it) and present that as this tool's result: if the file cannot be sent, tell the user.

輸入結構描述

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string"
    },
    "contentEncoding": {
      "type": "string"
    },
    "cursor": {
      "type": "string"
    },
    "file": {
      "additionalProperties": false,
      "properties": {
        "download_url": {
          "type": "string"
        },
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        }
      },
      "required": [
        "download_url",
        "file_id"
      ],
      "type": "object"
    },
    "fileRef": {
      "type": "string"
    },
    "filename": {
      "type": "string"
    },
    "filepath": {
      "type": "string"
    },
    "maxChars": {
      "type": "integer"
    },
    "outputFormat": {
      "type": "string"
    },
    "pdfBackend": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    }
  },
  "required": []
}
🟡submit_feedback(ailang_version, auto_dispatch, body, category, contact, ...)

Send a bug report, feature request, documentation gap or limitation about AILANG to the AILANG team. Use it only when the user asks to report something, and leave out personal or confidential information. Categories: bug, feature, docs, limitation. Body up to 10 KB, snippet up to 4 KB. `contact` is optional, for a reply. `package` (vendor/name) sends the report to that AILANG package's maintainers instead. Returns a ticket ID.

輸入結構描述

{
  "type": "object",
  "properties": {
    "ailang_version": {
      "type": "string",
      "description": "The reporter's CLI version (free-form, used for triage)"
    },
    "auto_dispatch": {
      "type": "boolean",
      "description": "Let the package maintainers' automation act on the report before a person reads it. Only if the user asks. Default false: a person triages it first."
    },
    "body": {
      "type": "string",
      "description": "Full description (≤10 KB)"
    },
    "category": {
      "type": "string",
      "description": "bug | feature | docs | limitation"
    },
    "contact": {
      "type": "string",
      "description": "Optional address for a reply. Only if the user gives one"
    },
    "package": {
      "type": "string",
      "description": "Optional vendor/name (e.g. \"sunholo/auth\") to send the report to that package's maintainers. Empty = the AILANG team."
    },
    "snippet": {
      "type": "string",
      "description": "Optional code/error snippet (≤4 KB)"
    },
    "title": {
      "type": "string",
      "description": "Short title for the report"
    }
  },
  "required": [
    "title",
    "body",
    "category",
    "ailang_version"
  ]
}
🟢uploadDocument(outputFormat)

Let the user pick a file to parse: shows the AILANG Parse card with a Choose file button. The card uploads the file and tries to summarise it for you; either way you get its fileRef. Then call mcpParse with that fileRef for the content (the same user can reuse it for 30 minutes; a large document comes in parts). Use this when the user wants to pick a file, or when createUpload's curl fails with a network error. For a file already in your sandbox or workspace, use createUpload + curl instead. Never parse the file yourself.

輸入結構描述

{
  "type": "object",
  "properties": {
    "outputFormat": {
      "type": "string"
    }
  },
  "required": []
}
🟡uploadViaHost(base64, filename, ticket)

Receive a file from the AILANG Parse upload widget, relayed by the host as base64. Only the widget calls this; ticket is the upload token it holds.

輸入結構描述

{
  "type": "object",
  "properties": {
    "base64": {
      "type": "string"
    },
    "filename": {
      "type": "string"
    },
    "ticket": {
      "type": "string"
    }
  },
  "required": [
    "ticket",
    "filename",
    "base64"
  ]
}

社群

為此伺服器評分

證據

近期觀測

已驗證未記錄版本10 個工具
已驗證未記錄版本12 個工具
已驗證未記錄版本12 個工具
已驗證未記錄版本12 個工具
已驗證未記錄版本12 個工具
已驗證未記錄版本10 個工具
已驗證未記錄版本10 個工具
已驗證未記錄版本10 個工具