Skip to main content
Glama
deenesjakoruzh

OrdiscanMCP

by Calel33
GitHub
TypeScript
MIT License
  • Linux
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

OrdiscanMCP v1

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

Lizenz: MIT

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 ) Remote: ( https://ordiscan-mcp-v1.onrender.com/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
-
license - not tested
-
quality - not tested

How are these scores calculated?

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. 1. Hauptwerkzeug
          2. 2. Adresstools (6)
          3. 3. Aktivitätstools (3)
          4. 4. Transaktionstools (4)
          5. 5. Beschriftungswerkzeuge (4)
          6. 6. Sammlungswerkzeuge (3)
          7. 7. Runenwerkzeuge (3)
          8. 8. BRC-20 Werkzeuge (2)
          9. 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

            • MCP Server for Binance Spot Trading

              kydlikebtc
              -
              security
              -
              license
              -
              quality
              This server provides a robust interface for Binance spot trading operations, including secure management of API credentials, execution and management of spot orders, and monitoring of account balances and open orders.
              Last updated -
              7
              13

            • Obsidian MCP REST Server

              PublikPrinciple
              -
              security
              -
              license
              -
              quality
              Provides a standardized interface for AI assistants to interact with Obsidian vaults through a local REST API, enabling reading, writing, searching, and managing notes.
              Last updated -
              58
              MIT License

            • mcp-inscription

              Laz1mov
              A
              security
              -
              license
              A
              quality
              Enable AI assistants to interact directly with Bitcoin Ordinals inscriptions. Seamlessly integrates with Goose and Claude Desktop to retrieve and display inscription content from transactions.
              Last updated -
              1
              3
              MIT License
              • Apple

            • Obsidian MCP Server

              pmmvr
              A
              security
              -
              license
              A
              quality
              A server that enables AI agents to perform sophisticated knowledge discovery and analysis across Obsidian vaults through the Local REST API plugin, supporting complex multi-step workflows with advanced filtering and full content retrieval.
              Last updated -
              3
              18
              MIT License

            View all related MCP servers

            New MCP Servers

            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