AILANG Parse
Parse, convert and create Office and PDF documents. OAuth at /mcp/connect/, API key at /mcp/.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"parse": {
"command": "npx",
"args": [
"@ailang/parse"
]
}
}
}실행 가능한 패키지
0.14.0stdio0.14.0stdio원격 엔드포인트
https://docparse.ailang.sunholo.com/mcp/streamable-httphttps://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"
]
}커뮤니티
증거