@toreador/mcp-server

Toreador를 위한 공식 Model Context Protocol 서버입니다. Claude Desktop, Cursor 및 기타 MCP 지원 어시스턴트가 사용자를 대신하여 암호화폐 QR 코드를 생성하고 결제 세션을 관리할 수 있도록 합니다.

⚠️ Toreador 대시보드에서 Pro 플랜 API 키(tdr_...)가 필요합니다. MCP 서버는 로컬에서 실행되며 귀하의 키를 사용하여 https://toreador.io/api/v1/public을 호출합니다.

노출된 도구

Claude Desktop에 설치

Claude Desktop의 설정 파일을 편집하세요:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

mcpServers 아래에 toreador 항목을 추가하세요:

{
  "mcpServers": {
    "toreador": {
      "command": "npx",
      "args": ["-y", "@toreador/mcp-server"],
      "env": {
        "TOREADOR_API_KEY": "tdr_your_key_here"
      }
    }
  }
}

Claude Desktop을 다시 시작하세요. 도구 메뉴에서 5개의 Toreador 도구를 확인할 수 있습니다.

Cursor에 설치

Cursor 설정 → MCP → "Add new MCP server"에 다음을 붙여넣으세요:

{
  "command": "npx",
  "args": ["-y", "@toreador/mcp-server"],
  "env": { "TOREADOR_API_KEY": "tdr_..." }
}

예시 프롬프트

설치가 완료되면 MCP 클라이언트에서 다음 프롬프트를 시도해 보세요:

• "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh 주소로 0.001 BTC를 보내기 위한 비트코인 QR 코드를 생성해 줘."

• "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18 주소로 Polygon 네트워크에서 50 USDC를 결제하기 위한 세션을 생성해 줘."

• "ses_123 세션의 상태가 뭐야?"

• "최근 결제 세션 10개를 보여줘."

어시스턴트가 적절한 도구를 선택하여 Toreador를 호출하고 결과를 반환합니다. 대부분의 클라이언트에서 인라인으로 렌더링할 수 있는 QR 코드 데이터 URI도 포함됩니다.

구성

신뢰 및 안전

• 로컬 전용. MCP 서버는 stdio를 통해 귀하의 컴퓨터에서 실행됩니다. API 키는 toreador.io로의 아웃바운드 HTTPS 호출을 제외하고는 컴퓨터 외부로 유출되지 않습니다.

• 비수탁형. Toreador는 자금을 보관하지 않습니다. MCP 도구는 QR 코드를 생성하고 세션 상태를 읽기만 하며, 자금을 이동시킬 수 없습니다.

• 읽기 또는 생성, 파괴 불가. 도구는 새로운 결제 객체를 생성하거나 기존 객체를 읽기만 합니다. "삭제" 또는 "환불" 도구는 없습니다.

소스에서 빌드

git clone https://github.com/Bentonabento/toreador-sdk.git
cd toreador-sdk/mcp
npm install
npm run build
TOREADOR_API_KEY=tdr_... node dist/index.js

서버가 부팅되면 stderr에 [toreador-mcp] ready (5 tools registered)를 출력하고 stdin에서 MCP 요청을 기다립니다.

라이선스

MIT