{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_k4nqey6d4f9c","handle":"yqzl-mcp-server","url":"https://wellknown.network/agents/yqzl-mcp-server","links":{"self":"https://wellknown.network/agents/yqzl-mcp-server/record.json","html":"https://wellknown.network/agents/yqzl-mcp-server","markdown":"https://wellknown.network/agents/yqzl-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/yqzl-mcp-server","status":"https://wellknown.network/api/v1/agents/yqzl-mcp-server/status","claim":"https://wellknown.network/agents/yqzl-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/yqzl-mcp-server/claim.json","badge":"https://wellknown.network/agents/yqzl-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:yqzl-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"yqzl-mcp-server","summary":"云启智联AI文档解析服务的 MCP (Model Context Protocol) 服务器","description":"# 云启智联 MCP Server\n\n云启智联AI文档解析服务的 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 服务器，让 Claude、Cursor、Windsurf 等支持 MCP 的 AI 客户端直接调用票据识别能力。\n\n## 功能\n\n- `parse_bank_receipt` — 银行回单解析（支持每页多张自动裁剪）\n- `parse_bank_statement` — 银行对账单解析\n- `parse_invoice` — 增值税发票解析\n- `parse_document` — 通用文档解析\n- `get_task_result` — 查询异步任务结果\n\n## 前置要求\n\n1. Python 3.10+\n2. 云启智联 API Key（从 [http://8.135.62.13:5000](http://8.135.62.13:5000) 注册获取）\n\n## 安装\n\n```bash\npip install yqzl-mcp-server\n```\n\n或从源码安装：\n\n```bash\ngit clone https://github.com/yunqi-zhilian/yqzl-mcp-server.git\ncd yqzl-mcp-server\npip install -e .\n```\n\n## 启动\n\n安装后，如果 `yqzl-mcp-server` 命令可用，直接运行：\n\n```bash\nyqzl-mcp-server\n```\n\n部分环境（尤其是 Windows）安装后脚本目录可能不在 PATH 中，导致命令找不到。此时可使用 Python 模块方式启动，效果完全相同：\n\n```bash\npython -m yqzl_mcp_server.server\n```\n\n## 在 Claude Desktop 中配置\n\n编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\\Claude\\claude_desktop_config.json`（Windows）：\n\n```json\n{\n  \"mcpServers\": {\n    \"yqzl-ai\": {\n      \"command\": \"yqzl-mcp-server\",\n      \"env\": {\n        \"YQZL_API_BASE_URL\": \"http://8.135.62.13:5000/AIService\"\n      }\n    }\n  }\n}\n```\n\n如果系统提示找不到 `yqzl-mcp-server` 命令（常见于 Windows），可将 `command` 改为使用 Python 模块方式启动：\n\n```json\n{\n  \"mcpServers\": {\n    \"yqzl-ai\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"yqzl_mcp_server.server\"],\n      \"env\": {\n        \"YQZL_API_BASE_URL\": \"http://8.135.62.13:5000/AIService\"\n      }\n    }\n  }\n}\n```\n\n配置完成后重启 Claude Desktop，即可在对话中让 Claude 调用票据识别工具。\n\n## 在 Cursor 中配置\n\n打开 Cursor Settings → MCP，添加 server：\n\n- Type: `stdio`\n- Name: `yqzl-ai`\n- Command: `yqzl-mcp-server`\n\n如果命令找不到，可改用：\n\n- Command: `python`\n- Args: `-m yqzl_mcp_server.server`\n\n## 使用示例\n\n对 AI 说：\n\n> 请用云启智联解析这张银行回单 `/Users/xxx/receipt.pdf`，API Key 是 `as-xxxxxxxx`。\n\nAI 会自动调用 `parse_bank_receipt` 工具并返回结构化结果。\n\n## 计费说明\n\nMCP Server 不掌握计费逻辑。所有调用都通过你的云启智联 API Key 进行，按量从你在云启智联平台的余额中扣费。具体价格见官网。\n\n## 自定义上游地址\n\n默认使用 `http://8.135.62.13:5000/AIService`。域名备案完成后，可通过环境变量切换：\n\n```bash\nexport YQZL_API_BASE_URL=\"http…","publisher":null,"homepage":null,"repository":null,"version":"0.1.1","license":"MIT","protocols":["mcp"],"tags":["bank-receipt","document-parsing","invoice","mcp","ocr"],"pricing":null,"endpoints":[{"url":"pypi:yqzl-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"documents.invoice-processing","name":"Invoice Processing","confidence":1,"provenance":"declared"},{"slug":"documents.ocr","name":"OCR","confidence":1,"provenance":"declared"},{"slug":"finance.banking","name":"Banking","confidence":0.967,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev","documents","finance"],"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":"yqzl-mcp-server","registry":"pypi","observedAt":"2026-09-10T16:24:29.808Z","publishedAt":"2026-06-19T05:02:03.974963Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"yqzl-mcp-server","url":"https://pypi.org/project/yqzl-mcp-server/","firstSeenAt":"2026-09-10T16:23:32.994Z","fetchedAt":"2026-09-10T16:23:32.994Z","normalizedAt":"2026-09-10T16:23:32.994Z"}]},"firstSeenAt":"2026-09-10T16:23:32.994Z","updatedAt":"2026-09-10T16:24:29.808Z"}