{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_kh9hyhjak3u3","handle":"mcp-document-parse","url":"https://wellknown.network/agents/mcp-document-parse","links":{"self":"https://wellknown.network/agents/mcp-document-parse/record.json","html":"https://wellknown.network/agents/mcp-document-parse","markdown":"https://wellknown.network/agents/mcp-document-parse/record.md","api":"https://wellknown.network/api/v1/agents/mcp-document-parse","status":"https://wellknown.network/api/v1/agents/mcp-document-parse/status","claim":"https://wellknown.network/agents/mcp-document-parse/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-document-parse/claim.json","badge":"https://wellknown.network/agents/mcp-document-parse/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-document-parse/history","tools":"https://wellknown.network/api/v1/agents/mcp-document-parse/tools"},"ard":{"identifier":"urn:air::server:mcp-document-parse","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-document-parse","summary":"MCP provider for document parsing and conversion to Markdown","description":"# MCP Document Parse Tool \n \n## 项目介绍 \n \n这是一个MCP（Model Communication Protocol）工具，用于帮助解析各种格式的文档（PDF、Word、Excel、PPT等）获取其内容。该工具提供了简单易用的接口，使您能够在各种应用中集成文档解析功能。 \n \n## 支持的文件格式 \n \n- PDF (.pdf) - 支持可编辑 PDF 和扫描件 \n- Word (.doc, .docx) \n- Excel (.xls, .xlsx) \n- PowerPoint (.ppt, .pptx) \n \n## 安装方法 \n \n### 使用 uv 安装并启动发布版 \n \n```bash \nuv tool install mcp-document-parse \n``` \n \n## 环境变量 \n \n- `NIUTRANS_API_KEY`（必填）：小牛翻译开放平台提供文档API的 API Key,可免费使用, 请登录后获取:https://niutrans.com/cloud/api/list \n- `NIUTRANS_DOCUMENT_APPID`（必填）：小牛翻译开放平台提供文档API的 APPID,可免费使用, 请登录后获取:https://niutrans.com/cloud/api/list \n \n## 计费说明 \n \n本工具使用小牛翻译开放平台的文档解析 API，计费规则如下： \n \n| 文件类型 | 计费标准 | \n|---------|---------| \n| PDF / Word / PPT | 1 页 = 2 积分 | \n| Excel | 2000 字符 = 2 积分 | \n \n> 💡 **免费额度**：平台每天赠送 **100 积分**，供大家免费使用！ \n \n## 环境要求 \n \n- Python >= 3.9 \n- 依赖项已在 `pyproject.toml` 中定义 \n \n## MCP 客户端配置示例 \n \n若通过 `uv tool install` 安装，可在 `mcp.json` 中配置： \n \n```json \n{ \n  \"mcpServers\": { \n    \"document_parse\": { \n      \"type\": \"stdio\", \n      \"command\": \"uv\", \n      \"args\": [ \n        \"tool\", \n        \"run\", \n        \"mcp-document-parse\" \n      ], \n      \"env\": { \n        \"NIUTRANS_API_KEY\": \"${env.NIUTRANS_API_KEY}\", \n        \"NIUTRANS_DOCUMENT_APPID\": \"${env.NIUTRANS_DOCUMENT_APPID}\" \n      } \n    } \n  } \n} \n``` \n \n启动支持MCP的应用后，执行 `ListTools` 即可看到 `parse_document_by_path` 工具，同时支持 `ListResources` 读取 `document://supported-types`。 \n \n \n## 工具说明 \n \n### parse_document_by_path \n \n将指定路径的文件转换为Markdown格式。 \n \n**参数：** \n- `file_path` (str): 文件的绝对路径，支持pdf、doc、docx、xls、xlsx、ppt、pptx格式 \n \n**返回：** \n- 成功: `{\"status\": \"success\", \"text_content\": \"文件内容\", \"filename\": 文件名}` \n- 失败: `{\"status\": \"error\", \"error\": \"错误信息\"}` \n \n \n### document://supported-types \n \n获取支持的文件类型信息。 \n \n**返回：** \n- 包含支持的文件类型列表及其描述的JSON对象 \n \n## 许可证 \n \nMIT License \n \n## 联系方式 \n \n如有问题或建议，请联系 tianfengning@niutrans.com","publisher":null,"homepage":"https://niutrans.com","repository":"https://github.com/niutrans/mcp-document-parse","version":"0.1.4","license":"MIT","protocols":["mcp"],"tags":["mcp","document","parsing","markdown","pdf","word","excel","ppt"],"pricing":null,"endpoints":[{"url":"pypi:mcp-document-parse","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"documents.spreadsheets","name":"Spreadsheets","confidence":1,"provenance":"declared"},{"slug":"documents.conversion","name":"Document Conversion","confidence":0.802,"provenance":"derived"},{"slug":"documents.presentations","name":"Presentations","confidence":0.802,"provenance":"derived"}],"categories":["documents"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-document-parse","registry":"pypi","observedAt":"2026-10-22T08:25:03.607Z","publishedAt":"2025-12-18T13:42:11.814585Z","latestVersion":"0.1.4"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-document-parse","url":"https://pypi.org/project/mcp-document-parse/","firstSeenAt":"2026-09-10T01:20:11.476Z","fetchedAt":"2026-10-22T08:23:45.354Z","normalizedAt":"2026-10-22T08:23:45.354Z"}]},"firstSeenAt":"2026-09-10T01:20:11.476Z","updatedAt":"2026-10-22T08:25:03.607Z"}