facturahub-mcp

<p align="center"> <img src="https://facturahub.com/logo.png" alt="FacturaHub — MCP 服务器，用于发票、WooCommerce、费用、POS 和商业管理，集成 Claude 和 ChatGPT" width="80" /> </p> <h1 align="center">FacturaHub — 适用于发票、WooCommerce、费用和商业管理的 MCP 服务器</h1> <p align="center"> <strong>69 种 AI 工具助您管理业务</strong><br/> 发票管理。WooCommerce 同步。费用跟踪。POS 和库存管理。税务申报。团队管理。后台管理面板。<code>npm install</code> 即可使用。 </p> <p align="center"> <a href="https://www.npmjs.com/package/facturahub"><img src="https://img.shields.io/npm/v/facturahub.svg?style=flat-square&color=CB3837" alt="npm 版本" /></a> <a href="https://www.npmjs.com/package/facturahub"><img src="https://img.shields.io/npm/dm/facturahub.svg?style=flat-square&color=blue" alt="npm 下载量" /></a> <a href="https://facturahub.com"><img src="https://img.shields.io/badge/Website-facturahub.com-7C3AED?style=flat-square" alt="官网" /></a> </p> --- ## FacturaHub 是什么？ FacturaHub 是一个 **MCP 服务器**（模型上下文协议），它将您的 AI 助手转变为一个完整的商业管理平台。无需在选项卡、电子表格和会计软件之间切换，只需与 Claude 或 ChatGPT 对话即可。 **一个服务器。69 种工具。涵盖所有业务操作。** 支持：**Claude Desktop** | **Claude Code** | **ChatGPT Desktop** | **ChatGPT Web** | **Cursor** | **Windsurf** | 任何 MCP 兼容客户端 --- ## WooCommerce 的 MCP FacturaHub 是 **WooCommerce MCP 服务器** - 直接在 Claude 或 ChatGPT 中管理您的在线商店： | 您说的话 | 会发生什么 | |---------|-------------| | "同步我的 WooCommerce 订单" | 自动将 WC 订单导入为发票 | | "从我的 WooCommerce 商店导入产品" | 同步您的 WC 目录并跟踪库存 | | "将此产品推送到 WooCommerce" | 将目录商品发送到您的 WC 商店 | | "为 WooCommerce 订单 #1234 创建发票" | 根据 WC 订单数据生成专业发票 | | "我的商店这个月卖了多少钱？" | 显示同步的 WooCommerce 销售收入报告 | **WooCommerce 集成功能：** - **订单同步** - WooCommerce 订单自动成为 FacturaHub 发票（自动或手动） - **产品同步** - 将您的 WC 产品导入目录并跟踪库存 - **推送产品** - 将目录商品发送回您的 WooCommerce 商店 - **Webhook 支持** - 实时 `order.updated` webhook 自动创建发票 - **OAuth 连接** - 通过 OAuth 2.0 一键连接 WooCommerce 适用于希望在 AI 助手中进行 AI 驱动的发票、费用跟踪和税务管理的 WooCommerce 商店所有者。 --- ## 发票和计费的 MCP 通过与 AI 对话创建、发送和管理发票： | 您说的话 | 会发生什么 | |---------|-------------| | "为 Acme Corp 创建一张 2,500 欧元的发票" | 自动创建发票和客户 | | "复制上个月的 Acme 发票" | 复制商品，生成新草稿 | | "发送 #042 发票给客户" | 标记为已发送，发送 PDF | | "标记 #042 发票为已支付" | 更新状态和支付日期 | | "下载上张发票的 PDF" | 生成带有徽标和税务详情的专业 PDF | | "显示逾期发票" | 列出逾期未支付的发票 | | "发送付款提醒" | 列出需要跟进的发票 | **10 种发票工具**：`create_invoice`、`update_invoice`、`delete_invoice`、`duplicate_invoice`、`send_invoice`、`list_invoices`、`get_invoice`、`mark_paid`、`download_pdf`、`send_reminder` --- ## 费用跟踪和会计的 MCP 使用 AI 驱动的分类跟踪每项业务费用： | 您说的话 | 会发生什么 | |---------|-------------| | "注册一笔 49 欧元的 Vercel 云托管费用" | 创建带有类别和税率的费用 | | "我的损益表这个月怎么样？" | 显示收入 vs 费用 vs 净利润 | | "我这个季度欠多少增值税？" | 显示增值税余额：已收取 vs 已支付 | | "显示我的现金流预测" | 根据待处理发票和定期费用进行预测 | | "年度收入总结" | 显示总收入、净利润和季度明细 | | "导出费用为 CSV" | 显示过滤后的费用数据下载链接 | **5 种费用工具 + 8 种报告工具**，涵盖损益表、税务总结、增值税余额、收入总结、现金流、账龄报告和客户收入。 --- ## POS 和库存管理的 MCP 使用 AI 运行零售 POS 和管理库存： | 您说的话 | 会发生什么 | |---------|-------------| | "打开 200 美元的收银机" | 开始一个新的 POS 会话 | | "添加销售：2 个咖啡杯，15 美元，现金" | 注册销售，调整库存 | | "关闭收银机，我数了 847 美元" | 关闭会话并显示对账报告 | | "在库存中添加 50 个产品 X" | 调整库存 | | "显示低库存商品" | 列出低于阈值的商品 | | "创建新产品：小工具，29.99 美元" | 添加到目录并跟踪库存 | **4 种 POS 工具 + 4 种目录工具**，实时跟踪库存、库存警报和 WooCommerce 同步。 --- ## 任务管理和看板的 MCP 使用完整的看板管理团队的工作： | 您说的话 | 会发生什么 | |---------|-------------| | "创建任务：审查 Acme 合同，优先级高" | 在待办事项中创建任务 | | "我的待处理任务" | 列出您的已分配任务 | | "将部署任务移到评审" | 验证状态转换 | | "将 onboarding 任务分配给 Maria" | 分配给团队成员 | | "团队面板怎么样？" | 概览：任务按状态和人员 | | "完成设计评审任务" | 从评审移到完成 | **9 种任务工具**，具有优先级（低/中/高/紧急）、分配、截止日期、标签和链接发票/客户。 --- ## 团队管理和后台管理的 MCP 适用于商业业主的完整后台功能： | 您说的话 | 会发生什么 | |---------|-------------| | "给我一个仪表盘概览" | 显示关键绩效指标：收入、费用、利润、逾期、待处理任务 | | "显示账龄报告" | 显示按逾期天数分类的应收账款（1-30、31-60、61-90、90+） | | "显示本季度按客户划分的收入明细" | 显示每个客户的收入百分比和未结余额 | | "本周发生了什么？" | 显示活动日志：谁做了什么以及何时 | | "邀请 maria@acme.com 成为财务人员" | 发送团队邀请并分配角色 | | "更改 Juan 的角色为运营" | 更新团队成员权限 | | "导出发票为 CSV" | 显示过滤后的数据导出链接 | **5 种团队工具 + 3 种后台工具**，具有角色（所有者、管理员、财务、运营、成员、查看者）、活动审计日志和数据导出。 --- ## 税务申报和电子发票的 MCP 处理多个国家的税务合规： | 您说的话 | 会发生什么 | |---------|-------------| | "生成我的季度增值税申报表" | 创建带有计算金额的税务申报表 | | "将此发票提交给 Panama 的 DGI" | 验证 RUC，通过 Factura Facil 提交，获取 CUFE | | "显示我今年的税务申报表" | 列出所有生成的申报表 | | "我欠多少 IVA？" | 显示增值税余额，详细到每张发票和费用 | **5 种税务申报工具 + 2 种电子发票工具**，支持巴拿马（DGI/FEP）、西班牙（Modelo 303）、墨西哥（CFDI/SAT）、哥伦比亚（DIAN）、阿根廷（AFIP）和美国。 --- ## 供应商管理和应付账款的 MCP 跟踪您欠供应商的款项： | 您说的话 | 会发生什么 | |---------|-------------| | "创建供应商：AWS，云托管" | 添加供应商到您的供应商列表 | | "注册来自 AWS 的供应商发票，1,200 美元" | 创建应付账款条目 | | "记录 AWS 发票的 500 美元付款" | 部分付款并重新计算余额 | | "显示未付供应商发票" | 按状态列出应付账款 | **4 种供应商工具 + 4 种供应商发票工具**，具有部分付款、账龄和供应商分析。 --- ## 商业记忆和 AI 上下文的 MCP 您的 AI 跨会话记住您的业务： | 您说的话 | 会发生什么 | |---------|-------------| | "记住 Acme 始终支付 30 天净额" | 保存到持久的商业上下文 | | "你知道关于我的业务什么？" | 读取生活文档 | | "更新业务摘要" | 重写执行概述 | **4 种商业记忆工具** - 您的 AI 建立一个关于您的客户、流程、定价和偏好的生活知识库。每次对话都更智能。 --- ## 所有 69 种 MCP 工具 | 类别 | 工具 | |----------|-------| | **发票** | `create_invoice` . `update_invoice` . `delete_invoice` . `duplicate_invoice` . `send_invoice` . `list_invoices` . `get_invoice` . `mark_paid` . `download_pdf` . `send_reminder` | | **客户** | `create_client` . `list_clients` . `get_client` . `update_client` . `delete_client` | | **费用** | `register_expense` . `list_expenses` . `get_expense` . `update_expense` . `delete_expense` | | **任务** | `create_task` . `list_tasks` . `get_my_tasks` . `get_task_overview` . `move_task` . `assign_task` . `update_task` . `complete_task` . `delete_task` | | **目录和库存** | `create_catalog_item` . `list_catalog_items` . `update_catalog_item` . `adjust_stock` | | **供应商** | `create_vendor` . `list_vendors` . `update_vendor` . `delete_vendor` | | **供应商发票** | `create_supplier_invoice` . `list_supplier_invoices` . `get_supplier_invoice` . `record_supplier_payment` | | **POS / 收银机** | `open_register` . `close_register` . `get_open_register` . `add_movement` | | **报告和分析** | `get_context` . `get_profit_loss` . `get_tax_summary` . `get_vat_balance` . `get_income_summary` . `get_cashflow` . `get_aging_report` . `get_revenue_by_client` | | **后台管理** | `get_dashboard_summary` . `get_activity_log` . `export_data` | | **团队管理** | `list_teams` . `list_team_members` . `invite_team_member` . `remove_team_member` . `change_member_role` | | **计费** | `get_billing_info` . `upgrade_plan` | | **税务申报** | `generate_tax_declaration` . `list_tax_declarations` . `get_tax_declaration` . `update_tax_declaration` . `submit_tax_declaration` | | **个人资料** | `get_profile` . `update_profile` | | **商业记忆** | `get_business_context` . `save_business_context` . `remove_business_context` . `save_business_summary` | | **电子发票** | `validate_invoice_panama` . `submit_to_dgi` | --- ## 快速开始 - 3 步骤，2 分钟，免费 ### 1. 创建您的账户 在 **[facturahub.com](https://facturahub.com/register)** 注册 - 免费，无需信用卡。 ### 2. 在您的 AI 中安装 ```bash npx -y facturahub setup --api-key=YOUR_API_KEY ``` 自动检测 Claude Desktop、ChatGPT Desktop、Claude Code 和 Cursor。 ### 3. 与您的 AI 对话 > *"为 Acme Corp 创建一张 2,500 欧元的发票，用于网页开发"* > *"同步我的 WooCommerce 订单并生成发票"* > *"我的损益表这个季度怎么样？"* --- ## 手动安装 | 客户端 | 配置文件 | |--------|-------------| | Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` | | Claude Code | `~/.claude/settings.json` | | Cursor | `~/.cursor/mcp.json` | | ChatGPT Desktop | `~/Library/Application Support/com.openai.chat/mcp.json` | ```json { "mcpServers": { "facturahub": { "command": "npx", "args": ["-y", "facturahub@latest"], "env": { "FACTURAHUB_API_KEY": "your-api-key", "FACTURAHUB_API_URL": "https://api.facturahub.com" } } } ``` ### ChatGPT Web（开发者模式） ```bash FACTURAHUB_API_KEY=your-api-key npx -y facturahub serve ``` 在 `http://localhost:8080/mcp`. ChatGPT：**设置** > **连接器** > **添加 MCP 服务器** > URL: `http://localhost:8080/mcp` --- ## 多用户团队 1. **创建您的团队** [facturahub.com](https://facturahub.com) 2. **邀请成员** 具有特定角色（管理员、财务、运营、成员、查看者） 3. **每个成员获取自己的 API Key** - 继承其角色权限 | 角色 | 访问权限 | |------|--------| | 所有者 / 管理员 | 一切：发票、费用、任务、报告、团队、设置 | | 财务 | 发票、客户、费用、报告 | | 运营 | 任务、客户 | | 成员 | 任务、客户、发票、费用 | | 查看者 | 报告（只读） | --- ## 国家和税务合规 适用于： | 国家 | 货币 | 税 | 电子发票 / 合规 | |---------|----------|-----|------------------------| | 巴拿马 | USD | ITBMS 7% | FEP via Factura Facil / DGI | | 西班牙 | EUR | IVA 21% | Modelo 303 / TicketBAI / VeriFactu | | 墨西哥 | MXN | IVA 16% | CFDI 4.0 / SAT | | 哥伦比亚 | COP | IVA 19% | DIAN 电子发票 | | 阿根廷 | ARS | IVA 21% | AFIP / 电子发票 | | Netherlands | EUR | BTW 21% | Peppol / UBL | | 美国 | USD | 销售税 | PDF 发票 | | Chile | CLP | IVA 19% | SII / DTE | | Peru | PEN | IGV 18% | SUNAT / 电子发票 | | Uruguay | UYU | IVA 22% | DGI / CFE | --- ## 使用案例：与您的堆栈集成 | 用例 | 工作原理 | ||||||| ### 1. WooCommerce 商店管理 在 WooCommerce 和 FacturaHub 之间同步订单、产品和库存 ### 2. 从 Telegram 发送费用 您的团队通过 Claude Channels 将费用发送到手机 ### 3. 从 Gmail 发送发票 在 AI 的帮助下查找本月的供应商发票并将其注册为费用 ### 4. Slack 通知 当发票逾期或任务完成时，Claude 会在 Slack 上通知 ### 5. GitHub 任务 合并 PR -> Claude 创建部署任务并分配 ### 6. Shopify / Stripe 同步 与 Stripe MCP 结合，自动对账 ### 7. 从 Excel 导入 粘贴您的电子表格 - Claude 解析并注册所有内容 ### 8. WhatsApp 发票 从 WhatsApp 消息创建发票和注册费用 --- ## 定价 | 计划 | 价格 | 包含 | |------|-------|----------| | **免费** | $0/mo | 核心功能，1 名成员，10 张发票/月 | | **入门** | $29/mo | 50 张发票，1 名成员，WooCommerce 同步 | | **成长** | $49/mo | 200 张发票，2 名成员，完整报告 | | **专业版** | $79/mo | 400 张发票，3 名成员，电子发票，优先支持 | | **商业版** | $199/mo | 1,500 张发票，10 名成员，无限电子发票 | **[创建免费账户 ->](https://facturahub.com/register)** --- ## CLI ```bash npx -y facturahub setup --api-key=XXX # 在所有 AI 客户端中安装 npx -y facturahub setup --target=cursor # 仅在 Cursor 中安装 npx -y facturahub setup --target=chatgpt # 在 ChatGPT Desktop 中安装 npx -y facturahub serve # ChatGPT Web 的 HTTP 服务器 npx -y facturahub status # 验证安装 npx -y facturahub version # 当前版本 npx -y facturahub update # 更新到最新版本 npx -y facturahub uninstall # 从所有客户端卸载 ``` --- ## 为什么选择 FacturaHub？ - **69 种 MCP 工具** - 最完整的商业 MCP 服务器 - **原生 WooCommerce** - 与您的在线商店同步订单、产品和库存 - **AI 原生** - 从一开始就为 Claude、ChatGPT、Cursor 和 Windsurf 构建 - **团队就绪** - 角色、权限、活动日志和共享的商业上下文 - **多国** - 10 多个国家的税务合规 - **免费永久层级** - 免费开始，无需信用卡，成长时升级 - **商业记忆** - 您的 AI 了解您的业务并随着时间的推移变得更智能 - **合规的电子发票** - DGI 巴拿马、SAT 墨西哥、DIAN 哥伦比亚、AFIP 阿根廷、SII 智利、SUNAT 秘鲁 - **实时 POS** - 收银机、库存跟踪、库存警报、消费者发票 - **管理员面板** - 仪表盘 KPI、账龄报告、收入分析、活动审计日志、CSV 导出 --- ## 链接 - **网站**：[facturahub.com](https://facturahub.com) - **npm**：[npmjs.com/package/facturahub](https://www.npmjs.com/package/facturahub) - **GitHub**：[github.com/Santy1422/facturahub-mcp](https://github.com/Santy1422/facturahub-mcp) --- 由 [Santiago Garcia](https://github.com/Santy1422) 在荷兰哈勒姆创建。 **标签**：MCP 服务器、模型上下文协议、WooCommerce MCP、WooCommerce 发票、WooCommerce AI、AI 发票、Claude MCP 服务器、ChatGPT MCP 服务器、Cursor MCP、发票自动化、费用跟踪、会计 AI、簿记 AI、自由职业者发票、小企业发票、创业公司发票、电子发票、CFDI、SAT 墨西哥、DGI 巴拿马、DIAN 哥伦比亚、AFIP 阿根廷、SII 智利、SUNAT 秘鲁、AEAT 西班牙、VeriFactu、TicketBAI、Peppol、UBL、BTW、IVA、ITBMS、IGV、增值税、销售税、税务申报、税务合规、应收账款、应付账款、账龄报告、POS 系统、销售点、收银机、库存管理、库存跟踪、目录管理、任务管理、看板、团队协作、团队管理、管理员面板、仪表盘、KPI、商业智能、收入分析、损益表、现金流、商业记忆、AI 上下文、多租户、多币种、PDF 发票、CSV 导出、WhatsApp 发票、电子商务发票、在线商店管理 ## FacturaHub 生态系统 - 🌐 [FacturaHub](https://facturahub.com?utm_source=github&utm_medium=referral&utm_campaign=mcp) — 应用程序（免费，包含 VeriFactu） - 🔌 [facturahub-api](https://github.com/FacturaHub-com/facturahub-api) — REST API + OpenAPI 3.1 - 🤖 [facturahub-mcp](https://github.com/FacturaHub-com/facturahub-mcp) — MCP 服务器（Claude、Cursor、ChatGPT） - 🧾 [facturahub-verifactu](https://github.com/FacturaHub-com/facturahub-verifactu) — 通过 API 的 VeriFactu - 🧮 库：nif-validator · iva · iban-es · factura-number · verifactu-qr · verifactu-hash · modelo-303 - ⚙️ 自动化：facturahub-n8n · n8n-nodes-facturahub · facturahub-woocommerce · facturahub-shopify 主题：Verifactu · 电子发票 · 增值税 · 模型 303 · AEAT · NIF/CIF · 自主 · MCP · AI · 西班牙