MCP-VizAPI: Visual Data Extraction with VizAPI.ai

MCP-VizAPI: Visual Data Extraction with VizAPI.ai

site icon
2025.05.07 0
Python视觉数据提取文档处理图像处理内容生成
vizapi-mcp-server 是一个与 VizAPI.ai 集成的 MCP 服务器,专门用于从图像和文档中提取结构化数据。该服务器允许兼容 Model Context Protocol (MCP) 的 AI 代理利用 VizAPI 强大的视觉数据提取能力。
View on GitHub

Overview

基本能力

产品定位

vizapi-mcp-server 是一个用于视觉数据提取的 MCP 服务器,主要服务于需要从图像和文档中提取结构化数据的 AI 代理。

核心功能

  • 列出可用提取模板:获取所有用户的私有模板。
  • 检索特定提取模板:通过 ID 获取特定模板。
  • 建议提取字段:分析文档/图像并建议可提取的字段。
  • 提取数据:使用预定义模板从文档/图像中提取结构化数据。
  • 健康检查:检查 VizAPI.ai 服务的运行状态。

适用场景

  • 自动化文档处理
  • 图像数据提取
  • 结构化数据生成

工具列表

  1. get_template_by_id:通过 ID 检索特定提取模板。
  2. list_templates:获取认证用户的所有私有模板。
  3. suggest_fields:分析文档/图像并建议提取字段。
  4. extract_values:使用模板从文档/图像中提取结构化数据。
  5. health_check:检查 VizAPI.ai 服务的运行状态。

常见问题解答

  • 如何获取 API 密钥:从 VizAPI.ai 仪表板 获取。
  • 如何配置环境变量:在 .env 文件中设置 VIZAPI_API_KEY 和其他必要变量。

使用教程

使用依赖

  • Python 3.12+
  • VizAPI.ai 账户和 API 密钥
  • Docker(推荐)

安装教程

使用 uv

  1. 安装 uv: bash pip install uv
  2. 克隆仓库: bash git clone <your_repository_url_here> cd vizapi-mcp-server
  3. 安装依赖: bash uv pip install -e .
  4. 创建 .env 文件: bash cp .env.example .env 或手动创建 .env 文件并配置 VIZAPI_API_KEY

使用 Docker

  1. 构建 Docker 镜像: bash docker build -t mcp/vizapi --build-arg PORT=8060 .
  2. 创建 .env 文件并配置 VIZAPI_API_KEY

调试方式

SSE 传输

uv run src/main.py

Stdio 传输

确保 .env 文件中 TRANSPORT=stdio 并设置 VIZAPI_API_KEY

Docker 运行

docker run --env-file .env -p 8060:8060 mcp/vizapi

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。