MCP Stripe Server

MIT License
13
  • Apple

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows to manage Stripe payment operations including customer management, payment intents, charges, and refunds through a structured API

MCP ストライプサーバー

Stripeと統合し、支払い、顧客管理、返金処理を可能にするModel Context Protocol(MCP)サーバー実装。このサーバーは、金融取引を安全に管理するための構造化APIを提供します。

デモ

要件

  • Python 3.8以上
  • MCP SDK 0.1.0+
  • ストライプ Python SDK
  • ドテンヴ

コンポーネント

リソース

サーバーは、すべての Stripe 操作の監査ログを提供します。

  • 顧客、支払い、返金操作の監査ログを保存します
  • 構造化されたログ記録をサポートし、トレーサビリティを向上
  • MCP リソース エンドポイントを使用して監査データを取得します

ツール

サーバーは、次のような Stripe API 操作を実装します。

顧客管理

  • customer_create : 新しい顧客を作成する
  • customer_retrieve : 顧客の詳細を取得する
  • customer_update : 顧客情報を更新する

支払い業務

  • payment_intent_create : 支払いを処理するための支払い意図を作成する
  • Charge_list : 最近の請求を一覧表示する

払い戻し業務

  • refund_create : 料金の払い戻しを作成する

特徴

  • 安全な支払い:Stripeとの統合により、堅牢な支払い処理を実現します。
  • 監査ログ: すべてのStripe取引を追跡します
  • エラー処理: 明確なメッセージによる包括的なエラー処理
  • MCP統合:MCP互換ツールとリソースリストをサポート

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Stripe Server を自動的にインストールするには:

npx -y @smithery/cli install @atharvagupta2003/mcp-stripe --client claude

依存関係をインストールする

python -m venv venv source venv/bin/activate # On macOS/Linux venv\Scripts\activate # On Windows pip install -e .

構成

.envファイルで環境変数を設定します。

STRIPE_API_KEY=your_stripe_secret_key

クロードデスクトップ

Claude Desktop 構成にサーバー構成を追加します。

Windows: C:\Users<ユーザー名>\AppData\Roaming\Claude\claude_desktop_config.json

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{ "mcpServers": { "stripe": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src", "run", "server.py" ] } } }

使用法

サーバーを起動する

uv run src/server.py

MCPコマンドの例

顧客を作成する

{ "tool": "customer_create", "arguments": { "email": "customer@example.com", "name": "John Doe" } }

顧客を取得する

{ "tool": "customer_retrieve", "arguments": { "customer_id": "cus_123456" } }

支払い意図を作成する

{ "tool": "payment_intent_create", "arguments": { "amount": 5000, "currency": "usd", "customer": "cus_123456" } }

払い戻しを作成する

{ "tool": "refund_create", "arguments": { "charge_id": "ch_abc123" } }

エラー処理

サーバーは、一般的なシナリオに対して明確なエラー メッセージを提供します。

  • API キーがありません: STRIPE_API_KEY が必要です
  • 無効なAPIキー: 認証エラー
  • 顧客が見つかりません: 顧客IDが無効です
  • 無効な入力: パラメータが不足しているか正しくありません

発達

テスト

対話型テストのために MCP Inspector を実行します。

npx @modelcontextprotocol/inspector uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/src run server.py

建物

  1. 依存関係を更新します:
uv compile pyproject.toml
  1. ビルドパッケージ:
uv build

貢献

貢献を歓迎します!詳細については貢献ガイドラインをご覧ください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

-
security - not tested
A
license - permissive license
-
quality - not tested

モデルコンテキストプロトコルを通じて支払い、顧客、払い戻しを処理するために Stripe と統合し、金融取引を管理するための安全な API を提供するサーバー。

  1. Demo
    1. Requirements
    2. Components
    3. Features
    4. Installation
    5. Usage
    6. Error Handling
    7. Development
    8. License
ID: wiypoirrk3