OrdiscanMCP v1
Ordiscan API 통합을 통한 MCP 프레임워크 HTTP 서버 구현.
특징
- 포트 1337에서 HTTP 스트림 전송
- 실시간 통신을 위한 스트림 응답 모드
- 포괄적인 Ordiscan API 통합(29개 도구)
- Zod 스키마 검증을 통한 TypeScript 구현
- 자세한 오류 처리 및 응답 형식
- 직접 API 연결(프록시 필요 없음)
- 베어러 토큰 인증
- Ordiscan API에서 처리되는 속도 제한
API 연결 및 인증
직접 연결
모든 도구는 프록시 없이 Ordiscan API( api.ordiscan.com )에 직접 연결됩니다. 이를 통해 다음이 보장됩니다.
- 더 빠른 응답 시간
- 지연 시간 감소
- 추가 구성이 필요하지 않습니다
- 직접 오류 처리
- Ordiscan API를 통한 자동 속도 제한
입증
모든 도구에는 Bearer 토큰을 사용한 인증이 필요합니다.
- API 키는 다음 중 하나로 제공되어야 합니다.
- 각 도구 호출의 매개변수로(
apiKey 매개변수) ORDISCAN_API_KEY 환경 변수를 통해
- 인증은 Bearer 토큰 형식을 사용합니다.
- 모든 요청에는
Authorization: Bearer <your-api-key> 헤더가 포함됩니다. - 유효하지 않거나 누락된 API 키로 인해 인증 오류가 발생합니다.
설정
- 종속성 설치:
지엑스피1
- 프로젝트를 빌드하세요:
- MCP 클라이언트를 구성하세요.
{
"mcpServers": {
"ordiscanmcpv1": {
"command": "npx",
"args": [
"mcp-remote",
"https://your-deployed-server.com/mcp"
]
}
}
}
url: ( http://localhost:1337/mcp ) 원격: ( https://ordiscan-mcp-v1.onrender.com/mcp )
- 서버를 시작합니다:
핫 리로드를 사용한 개발의 경우:
한 번 요청사항과 함께 열쇠를 건네주세요.
프로젝트 구조
ordiscanmcpv1/
├── src/
│ ├── tools/
│ │ ├── ordiscan-utils.ts
│ │ ├── ordiscan.ts # Main Ordiscan Tool
│ │ │
│ │ ├── # Address Tools
│ │ ├── ordiscan-utxo.ts
│ │ ├── ordiscan-inscriptions.ts
│ │ ├── ordiscan-inscriptions-detail.ts
│ │ ├── ordiscan-runes-balance.ts
│ │ ├── ordiscan-brc20-balance.ts
│ │ ├── ordiscan-rare-sats.ts
│ │ │
│ │ ├── # Activity Tools
│ │ ├── ordiscan-inscriptions-activity.ts
│ │ ├── ordiscan-runes-activity.ts
│ │ ├── ordiscan-brc20-activity.ts
│ │ │
│ │ ├── # Transaction Tools
│ │ ├── ordiscan-tx-info.ts
│ │ ├── ordiscan-tx-inscriptions.ts
│ │ ├── ordiscan-tx-inscription-transfers.ts
│ │ ├── ordiscan-tx-runes.ts
│ │ │
│ │ ├── # Inscription Tools
│ │ ├── ordiscan-inscription-info.ts
│ │ ├── ordiscan-inscription-traits.ts
│ │ ├── ordiscan-inscriptions-list.ts
│ │ ├── ordiscan-inscriptions-detail.ts
│ │ │
│ │ ├── # Collection Tools
│ │ ├── ordiscan-collections-list.ts
│ │ ├── ordiscan-collection-info.ts
│ │ ├── ordiscan-collection-inscriptions.ts
│ │ │
│ │ ├── # Rune Tools
│ │ ├── ordiscan-runes-list.ts
│ │ ├── ordiscan-rune-market.ts
│ │ ├── ordiscan-rune-name-unlock.ts
│ │ │
│ │ ├── # BRC-20 Tools
│ │ ├── ordiscan-brc20-list.ts
│ │ ├── ordiscan-brc20-info.ts
│ │ │
│ │ ├── # Sat Tools
│ │ ├── ordiscan-sat-info.ts
│ │ ├── ordiscan-utxo-rare-sats.ts
│ │ └── ordiscan-utxo-sat-ranges.ts
│ │
│ └── index.ts
├── package.json
├── tsconfig.json
└── README.md
매개변수 처리
모든 도구는 ordiscan-utils.ts 의 강력한 매개변수 처리 유틸리티를 사용합니다.
유연한 번호 처리
flexibleNumber() : 숫자 매개변수에 대해 문자열과 숫자 입력을 모두 허용합니다.- 문자열 숫자를 자동으로 정수로 변환합니다
- 해당되는 경우 숫자 범위를 검증합니다.
- 페이지 번호, 순서 번호 및 블록 높이에 사용됨
유연한 열거형 처리
flexibleEnum() : 미리 정의된 값에 대해 문자열 입력을 검증합니다.- 정렬 순서('최신'/'가장 오래된')에 사용됨
- 유형 필터 및 기타 열거형 값에 사용됨
- 잘못된 입력에 대한 명확한 오류 메시지를 제공합니다.
이러한 유틸리티는 유형 안전성과 유효성 검사를 유지하는 동시에 모든 도구에서 일관된 매개변수 처리를 보장합니다.
사용 가능한 도구(총 29개)
1. 주요 도구
- ordiscan_main : 룬 정보 및 상태를 위한 범용 도구
2. 주소 도구 (6)
- UTXO 도구 : 비트코인 주소가 소유한 모든 UTXO 가져오기
- 기본 및 상세 비문 도구 : 주소에 대한 비문 정보 가져오기
- 룬 밸런스 도구 : 주소에 대한 룬 밸런스를 가져옵니다.
- BRC-20 잔액 도구 : 주소에 대한 BRC-20 토큰 잔액 가져오기
- Rare Sats 도구 : 주소가 소유한 Rare Sats 가져오기
3. 활동 도구 (3)
- 비문 활동 도구 : 주소에 대한 비문 전송 추적
- 룬 활동 도구 : 주소에 대한 룬 전송 추적
- BRC-20 활동 도구 : 주소에 대한 BRC-20 토큰 전송 추적
4. 거래 도구(4)
- 거래 정보 도구 : 자세한 거래 정보를 얻으세요
- 거래 내역 도구 : 거래 내역 가져오기
- 거래 내역 전송 도구 : 거래 내역 전송 추적
- 거래 룬 도구 : 거래에서 룬 전송 추적
5. 비문 도구 (4)
- 비문 정보 도구 : 비문에 대한 자세한 정보를 얻으세요
- 비문 특성 도구 : 비문에 대한 특성 얻기
- 비문 목록 도구 : 모든 비문의 페이지별 목록을 가져옵니다.
- 비문 전송 도구 : 비문 전송 추적
6. 수집 도구 (3)
- 컬렉션 목록 도구 : 컬렉션의 페이지별 목록 가져오기
- 컬렉션 정보 도구 : 컬렉션에 대한 자세한 정보를 얻으세요
- 컬렉션 비문 도구 : 컬렉션에 비문을 가져옵니다
7. 룬 도구 (3)
- 룬 목록 도구 : 모든 룬 목록 가져오기
- 룬 시장 정보 도구 : 룬에 대한 시장 정보를 얻으세요
- 룬 이름 잠금 해제 도구 : 룬 이름 사용 가능 여부 확인
8. BRC-20 도구(2)
- BRC-20 목록 도구 : 모든 BRC-20 토큰 목록 가져오기
- BRC-20 토큰 정보 도구 : BRC-20 토큰에 대한 자세한 정보를 얻으세요
9. 위성 도구 (3)
- Sat Info Tool : 특정 위성에 대한 정보를 얻으세요
- UTXO Rare Sats 도구 : UTXO에서 희귀한 Sats를 가져옵니다.
- UTXO Sat 범위 도구 : UTXO의 Sat 범위 가져오기
도구 예제
비문 정보 도구
특정 비문에 대한 자세한 정보를 얻으세요.
도구 이름: ordiscan_inscription_info
매개변수:
id (문자열): 비문 ID(예: b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0)apiKey (문자열, 선택 사항): Ordiscan API 키
응답 예시:
{
"success": true,
"formatted": {
"id": "b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0",
"number": 123456,
"type": "image/png",
"timestamp": "2024-01-01 12:00:00",
"sat": "1,234,567",
"content_url": "https://ordinals.com/content/...",
"collection": "example-collection",
"owner": {
"address": "bc1...",
"output": "txid:vout"
},
"genesis": {
"address": "bc1...",
"output": "txid:vout"
}
}
}
룬 마켓 도구
특정 룬에 대한 시장 정보를 얻으세요.
도구 이름: ordiscan_rune_market
매개변수:
name (문자열): 룬의 고유 이름(스페이서 없음)apiKey (문자열, 선택 사항): Ordiscan API 키
응답 예시:
{
"success": true,
"formatted": {
"price": {
"sats": "1,234.56",
"usd": "$0.50"
},
"market_cap": {
"btc": "12.3456",
"usd": "$500,000"
}
}
}
BRC-20 정보 도구
BRC-20 토큰에 대한 자세한 정보를 얻으세요.
도구 이름: ordiscan_brc20_info
매개변수:
tick (문자열): 토큰의 고유한 tickapiKey (문자열, 선택 사항): Ordiscan API 키
응답 예시:
{
"success": true,
"formatted": {
"tick": "ORDI",
"supply": {
"max": "21,000,000",
"minted": "15,000,000",
"remaining": "6,000,000",
"percent_minted": "71.43%"
},
"market": {
"price_usd": "$1.23",
"market_cap_usd": "$18,450,000",
"fully_diluted_market_cap_usd": "$25,830,000"
}
}
}
오류 처리
모든 도구에는 포괄적인 오류 처리 기능이 포함되어 있습니다.
- API 키 검증
- 네트워크 요청 오류
- 잘못된 입력 검증
- Ordiscan API의 속도 제한 응답
- 자세한 오류 메시지
응답 형식
각 도구는 원시 응답과 형식화된 응답을 모두 제공합니다.
data 필드의 원시 데이터formatted 필드의 사람이 읽을 수 있는 포맷된 데이터- 모든 도구에서 일관된 오류 형식
- 적절한 숫자 형식 및 날짜 현지화
보안 권장 사항
API 키 관리
- 코드에 API 키를 하드코딩하지 마십시오.
- API 키 저장을 위해 환경 변수를 사용하세요
- API 키를 주기적으로 회전합니다
- 개발 및 프로덕션에 다른 API 키를 사용하세요
오류 처리
서버는 안전한 오류 처리를 구현합니다.
- 오류 메시지에 민감한 정보가 없습니다.
- 적절한 HTTP 상태 코드
- 구조화된 오류 응답
- 내부 정보를 노출하지 않고 오류 로깅
입력 검증
모든 도구는 엄격한 입력 검증을 사용합니다.
- 모든 매개변수에 대한 Zod 스키마 검증
- TypeScript를 사용한 유형 검사
- 숫자 입력에 대한 유연한 숫자 처리
- 열거형 값에 대한 문자열 검증
속도 제한
속도 제한은 Ordiscan API를 통해 처리됩니다.
- 추가 요금 제한이 필요하지 않습니다
- API 키 기반 속도 제한
- 속도 제한 초과에 대한 적절한 오류 응답
- 자동 요금 제한 처리