MCP 스트라이프 서버

Stripe와 통합되어 결제, 고객 및 환불을 처리하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버는 금융 거래를 안전하게 관리할 수 있는 구조화된 API를 제공합니다.

데모

요구 사항

• 파이썬 3.8 이상

• MCP SDK 0.1.0+

• 스트라이프 파이썬 SDK

• 도텐브

Related MCP server: Stripe MCP Server

구성 요소

자원

서버는 모든 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를 자동으로 설치하는 방법:

지엑스피1

종속성 설치

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: ~/라이브러리/애플리케이션 지원/클로드/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

2. 패키지 빌드:

uv build

기여하다

기여를 환영합니다! 자세한 내용은 기여 지침을 참조하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.