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

Related MCP server: Obsidian MCP REST Server

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

Installieren Sie Abhängigkeiten:

npm install

Erstellen Sie das Projekt:

npm run build

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 )

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

OrdiscanMCP

OrdiscanMCP v1

Merkmale

API-Verbindung und Authentifizierung

Direkte Verbindung

Authentifizierung

Aufstellen

Projektstruktur

Parameterbehandlung

Flexible Nummernverwaltung

Flexible Enumerationsverarbeitung

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)

Tool-Beispiele

Inschrift-Info-Tool

Runenmarkt-Tool

BRC-20-Infotool

Fehlerbehandlung

Antwortformatierung

Sicherheitsempfehlungen

API-Schlüsselverwaltung

Fehlerbehandlung

Eingabevalidierung

Ratenbegrenzung

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API