UnderDoc Tutorial - Expense Analytics using GenAI and MCP server for SQLite DB

基本能力

产品定位

该服务是一个教程项目，旨在展示如何使用GenAI和MCP服务器从收据、发票等图像中提取结构化费用数据，并将其存储到SQLite数据库中，以便进行费用分析和可视化。

核心功能

1. 从收据、发票等图像中提取结构化费用数据
2. 支持多语言（如中文、日文等）和多货币
3. 将提取的数据存储到SQLite数据库中
4. 使用Metabase进行费用分析和可视化
5. 支持批量处理图像数据

适用场景

1. 个人或企业需要从大量收据、发票等图像中提取结构化费用数据
2. 需要分析费用分布、分类等
3. 需要可视化费用数据
4. 处理多语言和多货币的费用数据

工具列表

1. UnderDoc: 用于从图像中提取结构化费用数据
2. SQLite: 用于存储提取的数据
3. Metabase: 用于费用分析和可视化
4. Docker: 用于运行Metabase
5. Python: 用于编写数据处理脚本

常见问题解答

1. 如何获取UnderDoc API Key？
2. 注册UnderDoc开发者账号
3. 登录后从"Key Management"页面获取API Key
4. 如何安装Docker？
5. 从Docker官网下载并安装Docker Desktop
6. 如何安装Python 3.12？
7. 使用Homebrew安装：brew install [email protected]
8. 如何安装SQLite命令行工具？
9. 使用Homebrew安装：brew install sqlite

使用教程

使用依赖

1. 获取UnderDoc API Key
2. 安装Docker
3. 安装Python 3.12 bash brew install [email protected]
4. 安装SQLite命令行工具 bash brew install sqlite

安装教程

1. 克隆项目 bash git clone https://github.com/under-doc/underdoc-expense-analytics-tutorial.git
2. 设置Python虚拟环境并安装依赖 bash python3.12 -m venv venv source venv/bin/activate pip install -r requirements.txt
3. 初始化SQLite数据库（可选） bash sqlite3 metabase-data/underdoc.db
4. 将收据图像放入receipt-images文件夹

调试方式

1. 设置环境变量 bash export UNDERDOC_API_KEY=<your_api_key>
2. 运行主脚本 bash python main.py
3. 验证数据 bash sqlite3 metabase-data/underdoc.db sqlite> .tables sqlite> select * from myexpense;
4. 运行Metabase bash docker run -d -p 3000:3000 \ -v ~/workspace/underdoc/underdoc-expense-analytics-tutorial/metabase-data:/metabase-data \ -e "MB_DB_FILE=/metabase-data/metabase.db" \ --name metabase metabase/metabase
5. 访问Metabase
6. 打开浏览器访问http://localhost:3000

许可证

该项目遵循 None 开源许可条款。