云启智联 MCP Server

基于 Model Context Protocol (MCP) 标准，让 Claude、Cursor、Codex、Windsurf 等 AI 客户端直接调用金融文档解析能力

一个标准协议，多个 AI 客户端，结构化数据触手可及

什么是 MCP Server？

Model Context Protocol (MCP) 是 Anthropic 提出的一种开放标准协议，用于让 AI 客户端安全、标准化地调用外部工具和数据源。通过 MCP Server，AI 不再只是"聊天"，而是能够直接操作真实世界的数据能力。

yqzl-mcp-server 是云启智联官方维护的 MCP 服务器，将银行回单解析、对账单解析、发票识别、通用文档解析等核心能力封装为标准 MCP Tools。开发者只需一次安装，即可在多个支持 MCP 的 AI 客户端中调用这些能力。

Claude

Claude Desktop

Anthropic 官方桌面客户端
Cursor

Cursor

AI 原生代码编辑器

Codex

OpenAI 代码智能体

更多客户端

Windsurf、Cline、ChatWise 等
只需一次安装，即可在 Claude、Cursor、Codex、Windsurf 等多个 AI 客户端中直接调用金融文档解析能力。像聊天一样让 AI 帮你处理银行回单、对账单、发票和通用文档，无需手写调用代码。

MCP 工具能力清单

yqzl-mcp-server 目前向 AI 客户端暴露以下 5 个工具，覆盖金融文档解析的主要场景：

工具名称 对应接口 能力描述
parse_bank_receipt bank_receipt_parsing 银行回单解析，支持每页多张回单自动裁剪为单张，自动提取付款人、收款人、金额、日期等关键信息，支持多银行格式。
parse_bank_statement bank_statement_parsing 银行对账单解析，自动识别交易明细、余额变动、对手方信息，支持多格式对账单文件。
parse_invoice invoice_parsing 增值税发票解析，支持普通发票、专用发票等多种发票类型的智能识别，提取发票代码、号码、金额、税额等要素。
parse_document file_parsing 通用文档解析，支持 PDF、图片等多种格式的金融文档通用解析，自动识别文档类型并提取结构化数据。
get_task_result async_result 查询异步处理任务的结果状态，支持任务进度跟踪和结果获取。
调用方式：在支持 MCP 的 AI 客户端中，直接使用自然语言指令，例如"请帮我解析这份银行回单"，AI 会自动选择并调用对应的工具，无需手动编写代码。

快速开始

1 准备环境

确保本地已安装 Python 3.10 或更高版本。可通过以下命令检查：

python --version

2 获取 API Key

前往 云启智联平台 注册账号，新用户注册即赠送 10 元体验金。

登录后进入 管理面板 - API Key 管理，创建您的专属 API Key。

3 安装 MCP Server

通过 pip 直接安装已发布的包：

pip install yqzl-mcp-server

或从源码安装（适合二次开发）：

git clone https://github.com/yunqi-zhilian/yqzl-mcp-server.git cd yqzl-mcp-server pip install -e .

4 配置环境变量

MCP Server 默认使用云启智联网关地址，可通过环境变量自定义：

  • YQZL_API_BASE_URL：云启智联 API 基础地址，默认 https://www.yunqi-zhilian.com/AIService
  • API Key 由 AI 客户端在每次调用工具时传入，无需在环境变量中预设

5 在 AI 客户端中使用

安装并配置完成后，直接在 AI 客户端对话中使用自然语言，例如：

请用云启智联解析这张银行回单 /Users/xxx/receipt.pdf，API Key 是 as-xxxxxxxx

AI 会自动调用 parse_bank_receipt 工具并返回结构化结果。

费用说明：MCP Server 本身不收取额外费用。每次调用会通过你的云启智联 API Key 按实际使用量计费，直接从账户余额中扣除。具体价格参考 API 文档。

Claude Desktop 配置教程

Claude Desktop 是 Anthropic 官方提供的桌面客户端，完整支持 MCP 协议。下面介绍如何将 yqzl-mcp-server 接入 Claude Desktop。

1 安装 Claude Desktop

前往 Claude 官网 下载并安装 Claude Desktop（macOS 或 Windows）。

2 安装 yqzl-mcp-server

在终端中运行：

pip install yqzl-mcp-server

3 编辑 Claude Desktop 配置文件

根据操作系统打开对应配置文件：

# macOS ~/Library/Application Support/Claude/claude_desktop_config.json # Windows %APPDATA%\Claude\claude_desktop_config.json

在 mcpServers 中添加如下配置：

{ "mcpServers": { "yqzl-ai": { "command": "yqzl-mcp-server", "env": { "YQZL_API_BASE_URL": "https://www.yunqi-zhilian.com/AIService" } } } }

4 重启 Claude Desktop

保存配置文件后，完全退出并重新启动 Claude Desktop。

启动后，点击左下角工具图标，若看到 yqzl-ai 及其下的 5 个工具，即表示配置成功。

5 开始使用

在 Claude 对话中输入测试指令：

请帮我解析这份银行回单 /path/to/receipt.png，API Key 是 as-xxxxxxxx

Claude 会请求调用 parse_bank_receipt 工具，点击允许后即可获得结构化解析结果。

Cursor 配置教程

Cursor 是一款 AI 原生代码编辑器，内置 MCP 支持。通过配置 yqzl-mcp-server，你可以在编码过程中直接让 AI 处理金融文档。

1 安装 Cursor

前往 Cursor 官网 下载并安装 Cursor。

2 安装 yqzl-mcp-server

在终端中运行：

pip install yqzl-mcp-server

3 在 Cursor 中添加 MCP Server

打开 Cursor，进入 Settings → MCP（或 Composer → MCP），点击添加 Server：

Type: stdio Name: yqzl-ai Command: yqzl-mcp-server

部分 Cursor 版本支持直接编辑配置文件，配置格式如下：

{ "mcpServers": { "yqzl-ai": { "command": "yqzl-mcp-server", "env": { "YQZL_API_BASE_URL": "https://www.yunqi-zhilian.com/AIService" } } } }

4 验证与使用

保存后，Cursor 会自动连接 MCP Server。在 Composer 或 Chat 中发送：

解析项目目录下的 invoice.pdf，提取发票代码和金额，API Key 是 as-xxxxxxxx

Cursor 会调用 parse_invoice 工具并返回结果，你可以将解析结果直接用于后续代码生成或数据分析。

Codex 配置教程

Codex 是 OpenAI 推出的代码智能体，支持通过 MCP 调用外部工具。将 yqzl-mcp-server 接入后，你可以在 Agent 会话中直接让 Codex 解析金融文档并生成对应代码。

1 安装 Codex CLI

前往 OpenAI Codex 官方仓库，按说明安装 Codex CLI 或确认你的 ChatGPT/Codex 环境已支持 MCP。

2 安装 yqzl-mcp-server

在终端中运行：

pip install yqzl-mcp-server

3 在 Codex 中添加 MCP Server

在 Codex 的配置中添加 yqzl-ai server。具体配置路径可能因版本不同而有所差异，通常为 ~/.codex/config.json 或在 Codex 命令行/设置界面中手动添加：

{ "mcpServers": { "yqzl-ai": { "command": "yqzl-mcp-server", "env": { "YQZL_API_BASE_URL": "https://www.yunqi-zhilian.com/AIService" } } } }
注意：Codex 对 MCP 的支持方式可能随版本更新而变化，若上述路径不适用，请参考 OpenAI 官方 Codex 文档中的最新 MCP 配置说明。

4 验证与使用

保存配置后重启 Codex，在 Agent 会话中发送类似指令：

解析 /path/to/statement.pdf 这份银行对账单，提取每笔交易的日期、金额和余额，API Key 是 as-xxxxxxxx

Codex 会自动调用 parse_bank_statement 工具，你可以基于返回的结构化数据继续让它生成入库脚本或财务分析代码。

其他兼容客户端

任何支持 MCP stdio 传输协议的 AI 客户端都可以接入 yqzl-mcp-server。以下为常见客户端的通用配置方式。

客户端 配置说明
Windsurf 打开 Settings → AI → MCP，添加 yqzl-mcp-server 作为 stdio 类型的 Server 即可。
Cline (VS Code 插件) 在 Cline 的 MCP Servers 配置中，添加 command 为 yqzl-mcp-server 的 server 条目。
ChatWise 进入设置中的 MCP 配置页，按 JSON 格式添加 yqzl-ai server 配置。
自定义客户端 只要客户端实现 MCP stdio client，均可通过 yqzl-mcp-server 命令启动并调用 5 个工具。
通用配置模板：所有兼容 MCP 的客户端均可使用以下 JSON 片段：
{ "mcpServers": { "yqzl-ai": { "command": "yqzl-mcp-server", "env": { "YQZL_API_BASE_URL": "https://www.yunqi-zhilian.com/AIService" } } } }
安全提示：API Key 是你的账户凭证，请勿将其上传到公开仓库或共享给他人。建议在客户端中以安全方式配置，或在对话中临时传入。