{"id":39099265,"url":"https://github.com/digitalcube/advanced-stripe-mcp-server","last_synced_at":"2026-01-17T19:01:28.811Z","repository":{"id":307080982,"uuid":"960169999","full_name":"digitalcube/advanced-stripe-mcp-server","owner":"digitalcube","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-04T03:08:19.000Z","size":61,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-29T11:12:18.081Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/digitalcube.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-04T01:15:09.000Z","updated_at":"2025-05-04T22:53:37.000Z","dependencies_parsed_at":"2025-07-29T11:12:21.386Z","dependency_job_id":"7ecfbaa8-cd79-4dec-880f-74dbae0ac2b1","html_url":"https://github.com/digitalcube/advanced-stripe-mcp-server","commit_stats":null,"previous_names":["digitalcube/advanced-stripe-mcp-server"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/digitalcube/advanced-stripe-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalcube%2Fadvanced-stripe-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalcube%2Fadvanced-stripe-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalcube%2Fadvanced-stripe-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalcube%2Fadvanced-stripe-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/digitalcube","download_url":"https://codeload.github.com/digitalcube/advanced-stripe-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitalcube%2Fadvanced-stripe-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28516540,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T18:55:29.170Z","status":"ssl_error","status_checked_at":"2026-01-17T18:55:03.375Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-17T19:01:27.511Z","updated_at":"2026-01-17T19:01:28.796Z","avatar_url":"https://github.com/digitalcube.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 日本語ドキュメント: advanced-stripe-mcp-server について\n\n## このプロジェクトについて\n\nadvanced-stripe-mcp-serverは、MCPプロトコル（Model Context Protocol）を活用して、複数のStripeアカウントを横断的に管理・操作することを可能にするサーバーです。このサーバーをClaudeなどのAIアシスタントと連携させることで、自然言語を使ってStripeアカウントのデータを検索・操作することができるようになります。\n\n## 主な機能\n\n### 複数Stripeアカウントの統合管理\n- 複数のStripeアカウントを一元管理\n- すべてのアカウントを横断して検索・操作が可能\n- 特定のアカウントに限定した操作も簡単に実行可能\n\n### 顧客（Customer）関連機能\n- 名前による顧客検索（`search_stripe_customer_by_name`）\n- メールアドレスによる顧客検索（`search_stripe_customer_by_email`）\n\n### サブスクリプション関連機能\n- 顧客ID、ステータス、商品IDなどによるサブスクリプション検索（`search_stripe_subscriptions`）\n\n### 請求書（Invoice）関連機能\n\n\n- 請求書リスト取得（`list_stripe_invoices`）\n- 請求書ID指定による詳細情報取得（`get_stripe_invoice_by_id`）\n- 顧客、ステータス、金額、サブスクリプションIDなどによる請求書検索（`search_stripe_invoices`）\n\n## 利用例（スクリーンショット）\n\n### メールドメインベースでの調査分析\n\n![スクリーンショット 2025-04-04 10 45 04](https://github.com/user-attachments/assets/38ee61bb-b6ab-4890-9841-aab6efb29935)\n\n### 請求書の検索\n\n![スクリーンショット 2025-04-04 10 31 52](https://github.com/user-attachments/assets/3bf80be6-03a4-4db6-b2e1-8488dba145da)\n\n### サブスクリプション分析\n\n![スクリーンショット 2025-04-04 10 34 33](https://github.com/user-attachments/assets/79e5aa72-8d0d-4731-89ca-71a2fd402112)\n\nClaude Desktopの分析（アナリティクス）機能を使えば、グラフなども作れます。\n\n![スクリーンショット 2025-04-04 10 35 18](https://github.com/user-attachments/assets/1d60c73a-8789-4de4-bc1b-ec07fa0d5b49)\n\n\n## このMCPサーバーで解決できる業務課題\n\n1. **複数アカウント管理の効率化**:\n   - 異なるStripeアカウントのデータを切り替えずに一度に検索・閲覧可能\n   - アカウントをまたいだデータの比較や分析が容易に\n\n2. **顧客サポート業務の効率化**:\n   - 顧客からの問い合わせに対して、名前やメールアドレスから素早く顧客情報を検索\n   - サブスクリプション状況や請求書履歴を迅速に確認\n\n3. **経理・財務管理の支援**:\n   - 請求書ステータスや金額による検索で未払い請求書の確認が容易に\n   - 複数アカウントの請求状況を一元的に把握\n\n4. **AI連携による業務自動化**:\n   - 「先月の未払い請求書をすべて表示して」などの自然言語での操作\n   - データ分析や傾向把握をAIに依頼可能\n\n## 使い方\n\n### 1. セットアップ\n\n#### 必要条件\n- Node.js (v18以上)\n- npm (v8以上)\n- Stripe APIキー（複数アカウント分）\n\n#### インストール手順\n\n1. リポジトリをクローン:\n```bash\ngit clone https://github.com/yourusername/advanced-stripe-mcp-server.git\ncd advanced-stripe-mcp-server\n```\n\n2. 依存パッケージのインストール:\n```bash\nnpm install\n```\n\n3. サーバーのビルド:\n```bash\nnpm run build\n```\n\n### 2. 設定\n\nClaude DesktopでMCPサーバーを使用するには、以下の設定ファイルを編集します:\n\n- macOSの場合: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windowsの場合: `%APPDATA%/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"advanced-stripe-mcp-server\": {\n      \"command\": \"/path/to/advanced-stripe-mcp-server/build/index.js\",\n      \"env\": {\n        \"STRIPE_AMIMOTO_ACCOUNT_APIKEY\": \"Amimotoの制限つきAPIキー\",\n        \"STRIPE_SHIFTER_ACCOUNT_APIKEY\": \"Shifterの制限つきAPIキー\",\n        \"STRIPE_FINANSCOPE_ACCOUNT_APIKEY\": \"FinanScopeの制限つきAPIキー\"\n      }\n    }\n  }\n}\n```\n\n#### 2.1. コマンドのパスを取得する方法\n\n`command`のパスは、`npm run build`を実行した場所（ディレクトリ）で、以下のコマンドを実行します。\n\n```bash\necho \"\\\"$(pwd)/build/index.js\\\"\"\n```\n\nこれで`command`に記述すべきパスが表示されます。\n例: `\"/Users/dc-okamotohidetaka/development/mcp-servers/advanced-stripe-mcp-server/build/index.js\"`\n\nmacOSの場合、`echo \"\\\"$(pwd)/build/index.js\\\"\" | pbcopy`でコピーまでできます。\n\n#### 2.2. Stripe APIキーの生成方法\n\nセキュリティリスク、インシデント発生リスク削減のため、「シークレットキー」の利用は禁止しています。\n`sk_`から始まるAPIキーを設定すると、エラーが出ますのでご了承ください。\n\n制限つきAPIキーは、ユーザーごとに発行してください。AWSと一緒です。\n作り方は、[Stripe のドキュメント](https://docs.stripe.com/keys?locale=ja-JP#create-restricted-api-secret-key)を参考にしましょう。\n権限は、「読み込み」の権限を全部につけておけばOKです。不安な方は @hidetaka まで。\n\n### 3. 使用例\n\nClaude Desktopにて、以下のような自然言語クエリが可能になります:\n\n- 「顧客の田中さんの最近の請求書を検索して」\n- 「先月の未払いの請求書をすべて表示して」\n- 「example@email.comに関連するサブスクリプションの状態を教えて」\n- 「1st_accountとall_accountの両方で、最近キャンセルされたサブスクリプションを比較して」\n\n### 3.1. データ取得に関する注意\n\nStripe APIの仕様および生成AIのコンテキストウィンドウの制限により、1アカウントあたり最大100件までのデータしか取得できません。この制限については将来的に改善を検討しています。\n\n「全件取ってきて」というと、「全アカウントのデータを完全に取得するには、表示されたnext_pageパラメータを使用して追加の請求書を取得する必要があります。」のようなメッセージが出てきます。その場合は、「続けて」のように指示してください。\n\n### 4. デバッグ\n\nMCPサーバーのデバッグには、MCP Inspectorを使用できます:\n\n```bash\nnpm run inspector\n```\n\nこれにより、ブラウザでデバッグツールにアクセスするためのURLが表示されます。\n\n## 開発者向け情報\n\n### ディレクトリ構造\n- `src/index.ts`: メインサーバーファイル（ツール定義など）\n- `src/libs/`: Stripe操作の基本クラスや共通関数\n- `src/operations/`: 各種Stripe操作（顧客、サブスクリプション、請求書など）\n\n### 追加機能の開発\n新しいStripe API機能を追加する場合は、以下の手順に従ってください:\n\n1. `src/operations/`に新しい操作を定義\n2. `src/index.ts`に新しいツールとして登録\n3. テストを作成して機能を検証\n\n### 環境変数\n- `STRIPE_*_ACCOUNT_APIKEY`: 各Stripeアカウントのシークレットキー\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalcube%2Fadvanced-stripe-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigitalcube%2Fadvanced-stripe-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalcube%2Fadvanced-stripe-mcp-server/lists"}