BoxTier Basketball Receipt

io.github.boyakh-jpg由 GitHub 账号 boyakh-jpg 发布v1.0.0更新于 Nov 2, 2026

Create a BoxTier-style PNG receipt from user-provided basketball game results.

已验证Streamable HTTP可网页运行位置与生活媒体与设计

概览

AI 生成的概览

BoxTier 让助手搜索韩国公开招募中的篮球约战房间、查看用户比赛记录,并生成 BoxTier 风格的 PNG 比赛战报。

可以做什么
  • 搜索当前公开招募中的篮球约战房间,并按地区、日期、时间或 3v3、5v5 等条件筛选
  • 在推荐或分享加入链接前,查询某个公开房间 ID 的当前详细条件
  • 查看 BoxTier 登录状态、已连接账号与战报生成额度
  • 列出已登录用户最近的篮球比赛记录
  • 生成 BoxTier 风格的篮球比赛战报 PNG,以 Base64 内联返回并提供短期下载链接
适用场景
适合在韩国寻找散场球局或球队对抗、查看自己的 BoxTier 比赛历史,或把已结束比赛的结果做成可分享的 BoxTier 风格战报图片时使用。
运行要求
需要连接 boxtier.kr 的远程 streamable HTTP 端点;未声明需要安装包、环境变量或请求头。部分工具作用于已登录的 BoxTier 账号,查看记录和生成战报需要先登录或关联账号。
安装前请注意
战报工具根据用户提供的比赛结果生成图片,以内联方式和短期下载链接返回,服务器称原样传递 API 返回的 PNG。账号相关工具会读取已连接用户的比赛记录与额度,请只连接你打算使用的账号。搜索与查询仅限公开且仍在招募的房间。

安装

在 SourceWeft 中

  1. 打开 控制台中的 BoxTier Basketball Receipt,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.boyakh-jpg%2Fboxtier/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "boxtier-basketball-receipt": {
      "type": "http",
      "url": "https://boxtier.kr/mcp"
    }
  }
}

README

RankBall

친구끼리 하는 농구 경기를 오늘의 판으로 등록하고, 경기 후 양팀 승인으로 전적과 티어를 남기는 React + Vite MVP입니다.

실행

bash
npm installnpm run dev

.env가 없어도 localStorage demo mode로 실행됩니다.

Supabase

Vite에서도 Vercel/Next 스타일의 NEXT_PUBLIC_* 환경변수를 읽도록 설정했습니다.

txt
NEXT_PUBLIC_SUPABASE_URL=...NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=...

Supabase 영속 저장은 supabase/migrations를 순서대로 적용합니다. Supabase 환경이 설정된 뒤 원격 로드가 실패하면 localStorage demo state로 후퇴하지 않고 원격 shell/error 상태를 유지합니다.

Supabase CLI migration

Production DB migration은 가능하면 Supabase CLI로 적용합니다.

powershell
supabase --version$env:SUPABASE_ACCESS_TOKEN="..."$env:SUPABASE_DB_PASSWORD="..."supabase link --project-ref olzxextphxpniwiiwwda --password $env:SUPABASE_DB_PASSWORDsupabase db push --linked --dry-runsupabase db push --linked

DATABASE_URL이 있으면 link 없이도 적용할 수 있습니다.

powershell
supabase db push --db-url "$env:DATABASE_URL" --dry-runsupabase db push --db-url "$env:DATABASE_URL"

Production 적용 뒤 schema health를 확인합니다.

powershell
Invoke-RestMethod -Method Post -Uri "https://boxtier.kr/api/system/schema-health" -Headers @{ Authorization = "Bearer $env:CRON_SECRET" }

배포 전 검증은 한 명령으로 실행합니다.

powershell
npm run verify:release -- --confirm-production=olzxextphxpniwiiwwda

verify:release는 production build 후 원격 Supabase/Auth 기반 전체 backend simulation과 schema health를 실행합니다. production ref와 정확히 같은 --confirm-production=<project-ref> CLI flag가 없으면 API/Auth 호출 전에 중단합니다. SUPABASE_SERVICE_ROLE_KEY, 테스트 Auth 환경변수, CRON_SECRET이 필요합니다. 종료 코드가 0이 아니면 배포하지 않습니다.

simulation은 실행 전에 environment, 직접 Supabase project ref, 원격 API host/ref를 stderr에 표시합니다. process당 전체 flow 반복 상한은 1회이고 자동 재시도는 cleanup 실패 시 최대 1회입니다. 별도 process를 다시 실행하는 외부 runner도 호출 횟수를 1회로 제한해야 합니다. --safety-check-only는 target guard만 검증하고 DB/API를 호출하지 않습니다.

테스트 전용 Supabase는 test URL, publishable key, service-role key를 함께 설정합니다. 원격 test API를 쓰면 실제 배포 대상과 같은 ref를 --remote-project-ref=<test-ref>로 추가합니다. 직접 ref와 원격 ref가 다르면 실행하지 않습니다.

원격 DB에는 supabase db reset --linked, DROP TABLE, TRUNCATE, 대량 DELETE를 쓰지 않습니다.

환경변수

이름위치용도
VITE_SUPABASE_URL / NEXT_PUBLIC_SUPABASE_URL브라우저/서버Supabase project URL
VITE_SUPABASE_PUBLISHABLE_KEY / NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY / VITE_SUPABASE_ANON_KEY브라우저Supabase anon/publishable key
SUPABASE_SERVICE_ROLE_KEY서버/스크립트 전용server action, seed, simulation
VITE_ENABLE_SERVER_ACTIONS브라우저server action 활성화
VITE_DEMO_LOGIN브라우저localhost 테스트 로그인 UI 허용
RANKBALL_SEED_REAL_TEST_AUTH / RANKBALL_SEED_AUTH_ONLY스크립트테스트 계정을 Supabase Auth user로 만들고 기존 profile에 연결
RANKBALL_TEST_PASSWORD / VITE_TEST_AUTH_PASSWORD스크립트/브라우저테스트 계정 password Auth용 비밀번호
RANKBALL_TEST_AUTH_EMAIL_DOMAIN / VITE_TEST_AUTH_EMAIL_DOMAIN스크립트/브라우저테스트 계정 email domain. 기본값 rankball.test
VITE_ASSET_BASE_URL / VITE_PUBLIC_ASSET_BASE_URL브라우저원격 asset base URL
VITE_NAVER_MAP_CLIENT_ID / VITE_NAVER_MAP_NCP_KEY_ID브라우저/서버 fallbackNaver map/geocode client id
NAVER_MAP_CLIENT_SECRET / NAVER_MAP_NCP_KEY / NAVER_MAP_NCP_CLIENT_SECRET서버 전용Naver geocode fallback secret
DISCORD_CLIENT_ID / DISCORD_CLIENT_SECRET / DISCORD_REDIRECT_URI서버 전용Discord OAuth
DISCORD_BOT_TOKEN / DISCORD_GUILD_ID / DISCORD_GUILD_IDS서버 전용Discord DM worker
DISCORD_PUBLIC_KEY서버 전용Discord interaction signature 검증
DISCORD_CHAT_BRIDGE_SECRET / DISCORD_CHAT_BRIDGE_URLbridge workerDiscord 방 채팅을 웹 API로 전달
DISCORD_CHAT_BRIDGE_REQUEST_TIMEOUT_MS / DISCORD_CHAT_BRIDGE_MAX_DELIVERY_ATTEMPTSbridge worker전달 timeout과 재시도 횟수. 기본 10000, 4
CRON_SECRET서버/스크립트 전용worker, maintenance, schema-health
SUPABASE_ACCESS_TOKENCLI 전용Supabase Management API 인증
SUPABASE_DB_PASSWORDCLI 전용supabase link, supabase db push --linked 원격 DB 비밀번호
SUPABASE_PROJECT_IDCLI/CI 전용Supabase project ref. 현재 production ref: olzxextphxpniwiiwwda
DATABASE_URLCLI/서버 전용supabase db push --db-url 또는 직접 Postgres 접속
RANKBALL_SIM_BASE_URL / RANKBALL_SIM_SECRET / RANKBALL_SIM_TIMEOUT_MS / RANKBALL_SIM_CLEANUP_TIMEOUT_MS스크립트backend simulation
RANKBALL_SIM_REMOTE_PROJECT_REF스크립트원격 test API가 사용하는 Supabase project ref. --remote-project-ref가 우선
RANKBALL_SIM_REPEAT / RANKBALL_SIM_MAX_RETRIES스크립트전체 flow 반복 상한 1, cleanup 재시도 상한 1

Discord 방 채팅 bridge

상시 실행 환경에서 아래 명령을 실행합니다. Gateway worker는 heartbeat ACK 누락 시 재연결하고, 가능한 세션은 resume하며, 웹 API의 timeout·429·5xx를 제한 횟수만큼 재시도합니다.

powershell
npm run discord:room-chat-bridge

운영에서는 DISCORD_CHAT_BRIDGE_SECRET을 별도로 설정합니다. CRON_SECRET fallback은 기존 배포 호환용입니다.

Vercel

Framework preset은 Vite, build command는 npm run build, output directory는 dist입니다.

来源:README.md,提交 fa8835b

工具

5

fetch

BoxTier 공개 농구 매칭방 상세 조회

search가 반환한 BoxTier 공개 농구 매칭방 ID 하나의 현재 상세 조건을 조회한다. 검색 결과를 추천하거나 참가 링크를 안내하기 전에 사용한다. 임의의 비공개 방이나 종료된 방 조회에는 사용하지 않는다.

输入参数id必填

get_my_boxtier_account

BoxTier 로그인 연결 확인

BoxTier 로그인을 시작하거나 현재 연결된 내 계정과 영수증 생성 한도 정책을 확인한다. 사용자가 로그인, 계정 연결, 내 기록 이용 가능 여부 또는 영수증 한도를 물으면 사용한다.

无需输入参数。

list_my_match_records

내 BoxTier 경기 기록 조회

로그인한 BoxTier 사용자의 최근 농구 경기 기록을 조회한다. 사용자가 내 경기, 내 기록, 이전 경기 또는 기록으로 영수증 만들기를 요청할 때 사용한다.

输入参数limitoffset

create_basketball_receipt

BoxTier 농구 영수증 PNG 만들기

박스티어(BoxTier) 스타일의 농구 경기 영수증 PNG를 만든다. 이 출력에는 BoxTier API만 사용한다. 성공 시 완성된 최종 PNG 한 장은 tool result의 content[0]에 type=image, mimeType=image/png, raw Base64 data로 직접 첨부되고, structuredContent.downloadUrl에는 동일 PNG 원본을 내려받는 단기 만료 링크가 제공된다. API가 반환한 PNG 원본만 사용자에게 그대로 전달하고 재합성·재렌더·임의 편집하지 않는다. 별도 위젯을 열지 않고 처리 중·완료 문구를 별도로 반복하지 않는다. 반환된 image content 또는 downloadUrl을 영수증 결과로 사용자에게 직접 제시하고 metadata만으로 완료 처리하지 않는다. structuredContent는 첨부 여부·바이트 길이·실제 크기·SHA-256 검증값을 제공한다. 네이티브 대화 이미지 첨부 여부와 기본 도구 실행 UI는 MCP 클라이언트가 결정한다. 사용자가 ‘박스티어로 영수증 만들어줘’, 농구 감열지 영수증, basketball game receipt, score receipt를 요청했고 팀명·최종 점수·경기 날짜·장소·경기 형식을 모두 실제 값으로 제공했을 때만 사용한다. 사용자가 엠블럼 이미지를 첨부하면 홈·원정에 맞춰 homeEmblemFile·awayEmblemFile로 전달한다. 원형 파일은 강제하지 않는다. 가능하면 투명 배경 정사각형 캔버스에 실제 도안만 담고 원형 테두리·회색 원판은 미리 넣지 않는다. 서버가 알파 전경의 실제 경계와 중심을 계산해 원형 안전영역 안에 비율 유지·자동 중앙 정렬하고 스타일 변환하며 저장하지 않는다. 경기사진은 지원하지 않으므로 boxtier.kr 영수증 페이지 이용을 안내한다. 누락값을 추측하지 말고 먼저 사용자에게 물어본다. 농구 외 경기, 허위 경기 기록, 상거래 영수증에는 사용하지 않는다.

输入参数stylevenue必填format必填localepresetcommentawayTeam必填homeTeam必填playedOn必填awayScore必填homeScore必填awayEmblem另有 8 个

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。