Stripe Tax MCP Server

🚀 Stripe 税务指南

Stripe 税务模块（Tax Module）为商家提供了在交易中自动计算和处理税费的功能，极大地简化了税务流程，同时确保商家的税务操作符合相关法规要求。

🚀 快速开始

📦 安装指南

安装 Stripe CLI

curl -L --proto '=https' --tlsv1.2 -o /usr/local/bin/stripe https://github.com/stripe/stripe-cli/releases/download/vlatest/stripe-linux-amd64.gz
chmod +x /usr/local/bin/stripe

配置

stripe tax settings --api-key=your_api_key

💻 使用示例

基础用法

创建税务计算

stripe tax calculation create \\
  --amount=100 \\
  --currency=usd \\
  --taxable-amount-type=gross \\
  --country-code=US \\
  --region-code=CA \\
  --shipping-address=addr1=line1&city=San%20Francisco&state=CA&postal_code=94103

更新产品税码

stripe tax product update \
  --product-id=prod_XYZ \
  --tax-code=TAXRATE_SALES

📚 详细文档

文档

• Stripe 税务文档
• Stripe 开票文档

工具

• Stripe CLI：用于与 Stripe API 交互的命令行工具。
• Stripe Dashboard：管理税务设置和监控税务数据的 web 控制台。

🔧 技术细节

常见问题排查

身份验证问题

错误：出现 "身份验证失败" 错误。 解决方法：

• 确保 API 密钥有效且格式正确。
• 检查密钥是否具有必要的权限。
• 对于受限密钥，确保其对税务端点有访问权限。

速率限制

错误：API 请求被拒绝，提示达到速率限制。 解决方法：

• 实现指数退避重试逻辑。
• 减少 API 调用频率。
• 考虑升级 Stripe 帐户以提高限额。

数据验证错误

错误：服务器拒绝税务设置更新。 解决方法：

• 确保所有必填字段格式正确。
• 检查国家代码是否为有效 ISO 代码（如 "US"、"CA"、"GB"）。
• 验证税号类型与预期格式匹配。

API 密钥问题

错误：出现 "未提供 API 密钥" 错误信息。 解决方法：

• 确保已创建 .env 文件并设置 STRIPE_API_KEY。
• 或者在调用方法时直接提供 API 密钥。
• 验证密钥是否具有处理 Stripe 税务操作的权限。

连接问题

错误：无法连接到 MCP 服务器。 解决方法：

• 检查服务器是否运行（查看控制台输出）。
• 确保客户端正确实现 MCP 协议。
• 使用 MCP 检查工具进行调试。
• 确认 claude_desktop_config.json 中的路径是否正确。

安全注意事项

⚠️ 重要提示

绝不要在代码中硬编码 Stripe API 密钥。

💡 使用建议

• 使用 .env 文件通过环境变量存储密钥。
• 在生产环境中，使用受限 API 密钥，仅授予所需的权限。
• 考虑实施 API 密钥轮换以增强安全性。
• 将 .env 添加到 .gitignore 文件中，防止意外提交密钥。