Skip to main content
Glama
deenesjakoruzh
Calel33

OrdiscanMCP

by Calel33
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

OrdiscanMCP v1

Ordiscan API 통합을 통한 MCP 프레임워크 HTTP 서버 구현.

라이센스: MIT

특징

  • 포트 1337에서 HTTP 스트림 전송

  • 실시간 통신을 위한 스트림 응답 모드

  • 포괄적인 Ordiscan API 통합(29개 도구)

  • Zod 스키마 검증을 통한 TypeScript 구현

  • 자세한 오류 처리 및 응답 형식

  • 직접 API 연결(프록시 필요 없음)

  • 베어러 토큰 인증

  • Ordiscan API에서 처리되는 속도 제한

Related MCP server: Obsidian MCP REST Server

API 연결 및 인증

직접 연결

모든 도구는 프록시 없이 Ordiscan API( api.ordiscan.com )에 직접 연결됩니다. 이를 통해 다음이 보장됩니다.

  • 더 빠른 응답 시간

  • 지연 시간 감소

  • 추가 구성이 필요하지 않습니다

  • 직접 오류 처리

  • Ordiscan API를 통한 자동 속도 제한

입증

모든 도구에는 Bearer 토큰을 사용한 인증이 필요합니다.

  • API 키는 다음 중 하나로 제공되어야 합니다.

    1. 각 도구 호출의 매개변수로( apiKey 매개변수)

    2. ORDISCAN_API_KEY 환경 변수를 통해

  • 인증은 Bearer 토큰 형식을 사용합니다.

  • 모든 요청에는 Authorization: Bearer <your-api-key> 헤더가 포함됩니다.

  • 유효하지 않거나 누락된 API 키로 인해 인증 오류가 발생합니다.

설정

  1. 종속성 설치:

지엑스피1

  1. 프로젝트를 빌드하세요:

npm run build

  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 )

  1. 서버를 시작합니다:

npm start

핫 리로드를 사용한 개발의 경우:

npm run dev

한 번 요청사항과 함께 열쇠를 건네주세요.

프로젝트 구조

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 (문자열): 토큰의 고유한 tick

  • apiKey (문자열, 선택 사항): 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 키 기반 속도 제한

  • 속도 제한 초과에 대한 적절한 오류 응답

  • 자동 요금 제한 처리

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Calel33/ordiscan-mcp-v1'

If you have feedback or need assistance with the MCP directory API, please join our Discord server