金大哥 - stripe-tax-mcp-server MCP 详情

article

README

🚀 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 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 文件中，防止意外提交密钥。

stripe-tax-mcp-server