Skip to main content
Glama
Sign In
deenesjakoruzh

OrdiscanMCP

by Calel33
GitHub
TypeScript
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Provides comprehensive Ordiscan API integration with 29 tools for interacting with Bitcoin blockchain data, including tools for retrieving information about UTXOs, inscriptions, BRC-20 tokens, runes, collections, transactions, and rare sats.

  • Uses npm for dependency management and project scripts, providing standardized commands for building, starting, and developing the MCP server.

  • Leverages TypeScript for implementation with strong typing and compile-time checking, enhancing reliability and maintainability of the MCP server.

OrdiscanMCP v1

Eine MCP Framework-HTTP-Serverimplementierung mit Ordiscan-API-Integration.

Merkmale

  • HTTP-Stream-Transport auf Port 1337
  • Stream-Response-Modus für Echtzeitkommunikation
  • Umfassende Ordiscan API-Integration (29 Tools)
  • TypeScript-Implementierung mit Zod-Schemavalidierung
  • Detaillierte Fehlerbehandlung und Antwortformatierung
  • Direkte API-Verbindung (kein Proxy erforderlich)
  • Authentifizierung per Bearer-Token
  • Ratenbegrenzung durch Ordiscan-API

API-Verbindung und Authentifizierung

Direkte Verbindung

Alle Tools verbinden sich direkt mit der Ordiscan-API ( api.ordiscan.com ), ohne dass ein Proxy erforderlich ist. Dies gewährleistet:

  • Schnellere Reaktionszeiten
  • Reduzierte Latenz
  • Keine zusätzliche Konfiguration erforderlich
  • Direkte Fehlerbehandlung
  • Automatische Ratenbegrenzung durch die Ordiscan-API

Authentifizierung

Jedes Tool erfordert eine Authentifizierung mit einem Bearer-Token:

  • Der API-Schlüssel muss entweder angegeben werden:
    1. Als Parameter in jedem Tool-Aufruf ( apiKey -Parameter)
    2. Über die Umgebungsvariable ORDISCAN_API_KEY
  • Die Authentifizierung verwendet das Bearer-Token-Format
  • Alle Anfragen enthalten den Header Authorization: Bearer <your-api-key>
  • Ungültige oder fehlende API-Schlüssel führen zu Authentifizierungsfehlern

Aufstellen

  1. Installieren Sie Abhängigkeiten:
npm install
  1. Erstellen Sie das Projekt:
npm run build
  1. Konfigurieren Sie Ihren MCP-Client:
{ "mcpServers": { "ordiscanmcpv1": { "command": "npx", "args": [ "mcp-remote", "https://your-deployed-server.com/mcp" ] } } }

URL: ( http://localhost:1337/mcp )

  1. Starten Sie den Server:
npm start

Für die Entwicklung mit Hot-Reload:

npm run dev

Geben Sie den Schlüssel einmalig bei einer Anfrage ein, und schon kann es losgehen.

Projektstruktur

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

Parameterbehandlung

Alle Tools verwenden robuste Dienstprogramme zur Parameterverarbeitung von ordiscan-utils.ts :

Flexible Nummernverwaltung

  • flexibleNumber() : Akzeptiert sowohl Zeichenfolgen- als auch Zahleneingaben für numerische Parameter
    • Konvertiert Zeichenfolgen automatisch in Ganzzahlen
    • Validiert numerische Bereiche, sofern zutreffend
    • Wird für Seitennummerierung, Ordnungszahlen und Blockhöhen verwendet

Flexible Enumerationsverarbeitung

  • flexibleEnum() : Validiert String-Eingaben anhand vordefinierter Werte
    • Wird für Sortierreihenfolgen ('neueste'/'älteste') verwendet
    • Wird für Typfilter und andere Aufzählungswerte verwendet
    • Bietet klare Fehlermeldungen bei ungültigen Eingaben

Diese Dienstprogramme gewährleisten eine konsistente Parameterverarbeitung über alle Tools hinweg und gewährleisten gleichzeitig die Typsicherheit und Validierung.

Verfügbare Tools (insgesamt 29)

1. Hauptwerkzeug

  • ordiscan_main : Allzweck-Tool für Runeninformationen und -status

2. Adresstools (6)

  • UTXO-Tool : Holen Sie sich alle UTXOs, die einer Bitcoin-Adresse gehören
  • Grundlegende und detaillierte Beschriftungstools : Erhalten Sie Beschriftungsinformationen für eine Adresse
  • Runen-Balance-Tool : Erhalten Sie Runen-Balancen für eine Adresse
  • BRC-20-Balance-Tool : Erhalten Sie BRC-20-Token-Salden für eine Adresse
  • Rare Sats Tool : Erhalten Sie seltene Sats, die einer Adresse gehören

3. Aktivitätstools (3)

  • Inscriptions Activity Tool : Verfolgen Sie Inscription-Übertragungen für eine Adresse
  • Runen-Aktivitätstool : Verfolgen Sie Runenübertragungen für eine Adresse
  • BRC-20-Aktivitätstool : Verfolgen Sie BRC-20-Token-Übertragungen für eine Adresse

4. Transaktionstools (4)

  • Transaktionsinfo-Tool : Erhalten Sie detaillierte Transaktionsinformationen
  • Tool für Transaktionsbeschriftungen : Erhalten Sie Beschriftungen in einer Transaktion
  • Tool für Transaktionsinskriptionsübertragungen : Verfolgen Sie Inskriptionsübertragungen in einer Transaktion
  • Tool für Transaktionsrunen : Verfolgen Sie Runenübertragungen in einer Transaktion

5. Beschriftungswerkzeuge (4)

  • Inschrift-Info-Tool : Erhalten Sie detaillierte Informationen zu einer Inschrift
  • Werkzeug für Inschriftenmerkmale : Merkmale für eine Inschrift abrufen
  • Tool zur Inschriftenliste : Erhalten Sie eine paginierte Liste aller Inschriften
  • Tool zur Übertragung von Inschriften : Verfolgen Sie die Übertragung einer Inschrift

6. Sammlungswerkzeuge (3)

  • Sammlungslisten-Tool : Erhalten Sie eine paginierte Liste der Sammlungen
  • Sammlungsinfo-Tool : Erhalten Sie detaillierte Informationen zu einer Sammlung
  • Tool für Sammlungsinschriften : Erhalten Sie Inschriften in einer Sammlung

7. Runenwerkzeuge (3)

  • Runenlisten-Tool : Holen Sie sich eine Liste aller Runen
  • Runenmarkt-Infotool : Erhalten Sie Marktinformationen für eine Rune
  • Tool zum Entsperren von Runennamen : Verfügbarkeit von Runennamen prüfen

8. BRC-20 Werkzeuge (2)

  • BRC-20-Listentool : Erhalten Sie eine Liste aller BRC-20-Token
  • BRC-20-Token-Infotool : Erhalten Sie detaillierte Informationen zu einem BRC-20-Token

9. Sat-Tools (3)

  • Sat Info Tool : Erhalten Sie Informationen zu einem bestimmten Satelliten
  • UTXO Rare Sats Tool : Holen Sie sich seltene Sats in einem UTXO
  • UTXO Sat Ranges Tool : Erhalten Sie Sat-Bereiche in einem UTXO

Tool-Beispiele

Inschrift-Info-Tool

Erhalten Sie detaillierte Informationen zu einer bestimmten Inschrift.

Werkzeugname: ordiscan_inscription_info

Parameter:

  • id (Zeichenfolge): Die Inschrift-ID (z. B. b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0)
  • apiKey (Zeichenfolge, optional): Ihr Ordiscan-API-Schlüssel

Beispielantwort:

{ "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" } } }

Runenmarkt-Tool

Erhalten Sie Marktinformationen zu einer bestimmten Rune.

Werkzeugname: ordiscan_rune_market

Parameter:

  • name (Zeichenfolge): Der eindeutige Name der Rune (ohne Abstandshalter)
  • apiKey (Zeichenfolge, optional): Ihr Ordiscan-API-Schlüssel

Beispielantwort:

{ "success": true, "formatted": { "price": { "sats": "1,234.56", "usd": "$0.50" }, "market_cap": { "btc": "12.3456", "usd": "$500,000" } } }

BRC-20-Infotool

Erhalten Sie detaillierte Informationen zu einem BRC-20-Token.

Werkzeugname: ordiscan_brc20_info

Parameter:

  • tick (Zeichenfolge): Der eindeutige Tick des Tokens
  • apiKey (Zeichenfolge, optional): Ihr Ordiscan-API-Schlüssel

Beispielantwort:

{ "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" } } }

Fehlerbehandlung

Alle Tools beinhalten eine umfassende Fehlerbehandlung:

  • API-Schlüsselvalidierung
  • Netzwerkanforderungsfehler
  • Validierung ungültiger Eingaben
  • Ratenbegrenzende Antworten der Ordiscan-API
  • Detaillierte Fehlermeldungen

Antwortformatierung

Jedes Tool bietet sowohl Rohdaten als auch formatierte Antworten:

  • Rohdaten im data
  • Für Menschen lesbare formatierte Daten im formatted Feld
  • Einheitliches Fehlerformat für alle Tools
  • Richtige Zahlenformatierung und Datumslokalisierung

Sicherheitsempfehlungen

API-Schlüsselverwaltung

  • Programmieren Sie API-Schlüssel niemals fest in Ihrem Code
  • Verwenden Sie Umgebungsvariablen für die Speicherung von API-Schlüsseln
  • Wechseln Sie regelmäßig die API-Schlüssel
  • Verwenden Sie unterschiedliche API-Schlüssel für Entwicklung und Produktion

Fehlerbehandlung

Der Server implementiert eine sichere Fehlerbehandlung:

  • Keine sensiblen Informationen in Fehlermeldungen
  • Richtige HTTP-Statuscodes
  • Strukturierte Fehlerantworten
  • Protokollierung von Fehlern ohne Offenlegung interner Komponenten

Eingabevalidierung

Alle Tools verwenden eine strenge Eingabevalidierung:

  • Zod-Schemavalidierung für alle Parameter
  • Typprüfung mit TypeScript
  • Flexible Zahlenverarbeitung für numerische Eingaben
  • String-Validierung für Aufzählungswerte

Ratenbegrenzung

Die Ratenbegrenzung wird von der Ordiscan-API übernommen:

  • Keine zusätzliche Ratenbegrenzung erforderlich
  • API-Schlüssel-basierte Ratenbegrenzungen
  • Richtige Fehlerreaktionen bei Überschreitung des Ratenlimits
  • Automatische Handhabung der Ratenbegrenzung

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Eine HTTP-Serverimplementierung, die direkten Zugriff auf die Ordiscan-API mit 29 integrierten Tools für Bitcoin-Ordinalzahlen, Inschriften, Runen, BRC-20-Token und seltene Sat-Daten bietet.

  1. Merkmale
    1. API-Verbindung und Authentifizierung
      1. Direkte Verbindung
      2. Authentifizierung
    2. Aufstellen
      1. Projektstruktur
        1. Parameterbehandlung
          1. Flexible Nummernverwaltung
          2. Flexible Enumerationsverarbeitung
        2. Verfügbare Tools (insgesamt 29)
          1. Hauptwerkzeug
          2. Adresstools (6)
          3. Aktivitätstools (3)
          4. Transaktionstools (4)
          5. Beschriftungswerkzeuge (4)
          6. Sammlungswerkzeuge (3)
          7. Runenwerkzeuge (3)
          8. BRC-20 Werkzeuge (2)
          9. Sat-Tools (3)
        3. Tool-Beispiele
          1. Inschrift-Info-Tool
          2. Runenmarkt-Tool
          3. BRC-20-Infotool
        4. Fehlerbehandlung
          1. Antwortformatierung
            1. Sicherheitsempfehlungen
              1. API-Schlüsselverwaltung
              2. Fehlerbehandlung
              3. Eingabevalidierung
              4. Ratenbegrenzung

            Related MCP Servers

            • Bybit MCP Server

              sammcj
              A
              security
              A
              license
              A
              quality
              A Model Context Protocol server that provides read-only access to Bybit's cryptocurrency exchange API, allowing users to query real-time cryptocurrency data using natural language.
              Last updated -
              9
              5
              TypeScript
              MIT License

            • MCP Blockchain Query Server

              pavel-bc
              -
              security
              F
              license
              -
              quality
              A Model Context Protocol server providing tools for querying Bitcoin blockchain data via Blockchain Data and Query APIs, supporting various BTC information retrieval functions.
              Last updated -
              Python
              • Linux
              • Apple

            • Model Control Plane (MCP) Server

              dvladimirov
              -
              security
              A
              license
              -
              quality
              A server implementation that provides a unified interface for OpenAI services, Git repository analysis, and local filesystem operations through REST API endpoints.
              Last updated -
              Python
              GPL 3.0
              • Linux
              • Apple

            • ScrAPI MCP Server

              DevEnterpriseSoftware
              -
              security
              -
              license
              -
              quality
              A server that enables web scraping of difficult-to-access websites affected by bot detection, captchas, or geolocation restrictions, returning results in either HTML or Markdown format.
              Last updated -
              1
              JavaScript

            View all related MCP servers

            New MCP Servers

            ID: 6iv3s6543n