stripe-mcp 是一个 FastMCP 3.4+ 服务器和 SOTA React Web 仪表盘，旨在将自主 AI 代理（Claude Desktop、Antigravity IDE、OpenManus）与人工操作员连接至 Stripe 支付处理、客户支持运营、订阅管理，以及 奥地利/欧盟区域税务合规（增值税 20%/10%/13%、欧盟 ATU 反向征收，以及 BAO § 132 财会记录保留）。
# Navigate to repository
cd D:\Dev\repos\stripe-mcp
# Install dependencies via uv
uv sync
# Launch Backend (Port 11165) & React Webapp (Port 11166)
.\start.ps1启动后，打开 http://127.0.0.1:11166 即可与 Web 仪表盘交互。
Related MCP server: Stripe MCP Server
💳 客户与扣款操作：创建客户、更新元数据、获取扣款记录并跟踪争议。
🔁 订阅管理：跟踪活跃订阅者，暂停、恢复、取消订阅，并监控 MRR 与流失 KPI。
🛍️ 3DS2 结账生成器：生成支持 银行卡、EPS 网银 和 SEPA 直接借记 的 Stripe Payment Links 与 Checkout Sessions。
🛡️ 财务安全上限：严格硬性上限（MAX_REFUND_AMOUNT_EUR = €500.00）可阻止未经授权的代理退款超额行为。
🇦🇹 奥地利与欧盟税务合规：
自动计算 20% 标准增值税 及 10% / 13% 低税率（UStG 1994）。
针对 0% 反向征税（ATU\d{8}）的 VIES/EU 增值税号格式验证。
BAO § 132 七年财政发票归档锁定元数据。
🖥️ SOTA React Web 仪表盘（端口 11166）：一站式 UI，包含仪表盘、客户目录、订阅管理器、退款工作室、发票工作室、Webhook 收件箱、工具工作台、技能、LLM 聊天、设置、帮助与审计日志。
⚡ 测试直至接入（Mock-until-Onboarded）：在连接 Stripe Restricted API Key（rk_test_...）之前，开箱即用地使用合成的奥地利数据。
+-----------------------------------------------------------------------+
| AI AGENT HOST |
| (Claude Desktop / Antigravity IDE / OpenManus / Cursor) |
+-----------------------------------------------------------------------+
|
(FastMCP stdio / HTTP /mcp)
v
+-----------------------------------------------------------------------+
| stripe-mcp FastMCP 3.4+ SERVER |
| (Port 11165 REST/MCP) |
| |
| +------------------------+ +-------------------------------------+ |
| | austria_tax.py Engine | | Portmanteau Tools | |
| | - 20%/10%/13% VAT | | - manage_stripe_customers | |
| | - ATU Syntax Checker | | - manage_stripe_subscriptions | |
| | - Reverse Charge | | - manage_stripe_payments | |
| | - BAO § 132 Metadata | | - manage_stripe_checkout | |
| +------------------------+ +-------------------------------------+ |
+-----------------------------------------------------------------------+
| |
(Stripe REST API) (SSE & REST /api)
v v
+-----------------------+ +-------------------------------+
| Stripe Cloud Platform| | React + Vite Webapp Dashboard |
| - API Gateway | | (Port 11166) |
| - Webhooks Ingest | | - Hero & KPIs (MRR/VAT) |
| - EPS / SEPA / PSD2 | | - Mock-until-onboarded |
+-----------------------+ | - Catch-them-all Pages |
+-------------------------------+双人验证规则（代表人 & UBO）：根据欧盟第五反洗钱指令与奥地利 KYC 规定，Stripe 要求同时验证 账户代表人 和所有 最终受益人（UBO）（持有 >25% 股权或共同经营董事）。对于标准企业架构（例如两人合伙的 GmbH），两人均须提交身份与地址证明。
地址证明（Meldezettel / Meldebestätigung）：必须为最近办理的（开具时间在 3 至 6 个月内）。带照片证件（护照）与地址证明（Meldezettel）必须分为两份单独文件。
奥地利税法（UStG 1994）：标准税率 20%，低税率 10%/13%，反向征税 0% 零税率。
BAO § 132：强制性 7 年法定发票保留锁定。
领域 | 文档链接 | 说明 |
🖥️ Web 仪表盘 | React 18、Vite、TailwindCSS 仪表盘指南与配置。 | |
🐍 Python 后端 | 核心 FastMCP 服务端、工具和税务引擎参考。 | |
📚 主文档体系 | 入驻、配置、工具和故障排查指南索引。 | |
📖 系统与帮助手册 | 完整 Stripe 系统手册、工具资源配置工具和 KYC 规则。 | |
🚀 入驻执行手册（Onboarding Runbook） | 分步骤的账户注册与 Meldezettel 验证指南。 | |
⚙️ 配置 | 环境变量与财务安全上限配置。 | |
🛠️ 工具参考 | 所有工具的完整参数模式与返回类型。 | |
📝 MCPB 提示词 | MCPB 3-4-100 提示词指标与验证。 | |
🧪 测试套件 | Pytest 测试套件与合规断言。 | |
🔧 脚本 | 维护与 MCPB 打包脚本。 |
以 MIT 许可证分发。详细信息请参见 LICENSE。
This server cannot be deployed
Stripe payments for AI agents. Create links, verify, manage customers.
Luxembourg payments for AI agents — cards / Apple Pay via Stripe. Never holds funds.
Austria payments for AI agents — EPS via Stripe. Never holds funds.
Estonia payments for AI agents — cards / Apple Pay via Stripe. Never holds funds.