paid-mcp-metering

호출당 과금되는 계량형 MCP 도구입니다.

디스커버리는 무료입니다: POST /mcp는 Model Context Protocol(initialize, tools/list, ping)에 따라 JSON-RPC 2.0을 사용합니다. 실행은 계량됩니다: POST /v1/t/{tool}은 x402 v2 페이월 뒤에 있습니다. 결제되지 않은 요청은 결제 요구 사항과 함께 HTTP 402 응답을 받습니다. 결제된 요청은 PAYMENT-SIGNATURE 헤더를 보유하며 도구가 실행되기 전에 퍼실리테이터를 통해 USDC를 정산합니다.

도구

업스트림은 Exa(기본)와 Tavily(폴백)입니다. 모든 핸들러는 실시간 업스트림 출력을 반환하거나 예외를 던집니다. 사전에 준비된 응답은 없습니다.

Related MCP server: Base Intel Search

설정

x402 v2, USDC, EIP-155 네트워크는 X402_NETWORK로 선택합니다(기본값 Base Sepolia 테스트넷, CAIP-2 eip155:84532). 퍼실리테이터 기본값은 https://x402.org/facilitator입니다.

실행

npm install
npm run build
npm start          # node dist/x402-server.js
npm test           # build + node --test dist/test-x402.js

무료 디스커버리:

curl -s localhost:4021/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

유료 실행:

curl -s localhost:4021/v1/t/web_search -H 'Content-Type: application/json' \
  -d '{"query":"x402 protocol","max_results":3}'
# -> 402 with payment requirements; pay via an x402 client and retry with PAYMENT-SIGNATURE

레지스트리

server.json은 공식 MCP Registry를 io.github.dev55acc-ai/paid-mcp-metering으로 지정합니다. v* 태그를 달면 .github/workflows/publish-mcp.yml이 실행됩니다: 테스트, 빌드, npm publish(NPM_TOKEN이 설정된 경우), 그리고 GitHub OIDC로 인증되는 레지스트리 배포 — 저장된 레지스트리 자격 증명이 없습니다.

라이선스

MIT