AI导哈

发票生成服务器

MAD invoiceMCP是一个本地发票生成服务器，通过JSON数据和LaTeX模板为自由职业者和小型企业创建、存储和渲染发票。

  • by mad-sol-dev
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 BadlyDrawnBoy/mad-invoice-mcp

使用说明

MAD发票MCP服务器

机电一体化咨询与设计（M.A.D.解决方案）–JSON→ LaTeX→ 带有本地文件存储的PDF发票服务器。

这是什么？

MAD发票MCP是一个小型模型上下文协议（MCP）服务器，允许您创建、存储和呈现发票 单一公司 使用JSON数据和LaTeX模板。

它专为本地单用户工作流而设计：

  • 一个存储库和一个 .mad_invoice/ 数据目录
  • 无多租户或多项目切换
  • 无外部数据库或云后端

最适合： 希望在自己的机器上生成发票的自由职业者和小企业。

非设计为：

  • 为拥有众多客户的税务顾问或代理机构提供的多租户系统
  • 托管SaaS产品
  • 完整的会计或ERP系统

主要特点

  • JSON → LaTeX→ PDF发票渲染管道
  • 草案→ 具有不可变最终发票的最终生命周期
  • 付款状态跟踪(open, paid, overdue, cancelled)
  • 可选增值税处理和德国§19 UStG（“小企业”）模式
  • 语言识别标签和日期（德语/英语）
  • 现有发票的简单网络概述和详细页面
  • 用于列出、读取、更新和呈现发票的MCP工具

需求

  • python：3.10或更高版本（用3.11测试）

  • LaTeX：最近的TeX Live版本（推荐2024或更新版本）

    • 或者使用Docker镜像，其中已经包含TeX Live

  • 可选： Docker，如果你不想在本地管理Python和LaTeX

默认情况下，可写工具处于禁用状态。要允许创建或更新发票，请设置：

export MCP_ENABLE_WRITES=1

快速入门

选项A–Docker（建议第一次尝试）

从存储库根目录：

docker build -t mad-invoice-mcp .
docker run --rm \
  -p 8000:8000 \
  -v $(pwd)/.mad_invoice:/app/.mad_invoice \
  -e MCP_ENABLE_WRITES=1 \
  mad-invoice-mcp

然后在浏览器中打开web UI：

http://localhost:8000/invoices

容器映像已包含最近的TeX Live安装，因此您不需要主机上的LaTeX。

选项B–本地MCP服务器（stdio）

如果您的计算机上安装了兼容的TeX Live，请使用此路径。

  1. 创建虚拟环境并安装依赖项：

    python -m venv .venv
source .venv/bin/activate  # on Windows: .venv\Scripts\activate
pip install -r requirements.txt

  2. 通过stdio启动MCP服务器：

    MCP_ENABLE_WRITES=1 python -m bridge --transport stdio

然后，大多数支持MCP的客户端（Claude Desktop、Cline、Continue等）都可以使用其标准指向此服务器 command/args 配置。看 MCP客户端配置 具体示例。

下一步去哪里

代码生成通知

这个存储库的大部分代码最初都是用人工智能助手生成的。该项目由人工维护和审查，但您仍应将其视为实验软件，并在将其用于生产之前仔细审查。

许可证

看 许可证 获取许可详情。

相关 MCP