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

Реализация HTTP-сервера MCP Framework с интеграцией API Ordiscan.

Лицензия: Массачусетский технологический институт

Функции

  • HTTP-потоковый транспорт через порт 1337

  • Режим потокового ответа для общения в реальном времени

  • Комплексная интеграция API Ordiscan (29 инструментов)

  • Реализация TypeScript с проверкой схемы Zod

  • Подробная обработка ошибок и форматирование ответа

  • Прямое API-подключение (прокси-сервер не требуется)

  • Аутентификация токена на предъявителя

  • Ограничение скорости, осуществляемое API Ordiscan

API-подключение и аутентификация

Прямое подключение

Все инструменты подключаются напрямую к API Ordiscan ( api.ordiscan.com ) без необходимости использования прокси. Это гарантирует:

  • Более быстрое время отклика

  • Уменьшенная задержка

  • Дополнительная настройка не требуется

  • Прямая обработка ошибок

  • Автоматическое ограничение скорости с помощью API Ordiscan

Аутентификация

Каждый инструмент требует аутентификации с использованием токена Bearer:

  • Ключ API должен быть предоставлен либо:

    1. Как параметр в каждом вызове инструмента (параметр apiKey )

    2. Через переменную среды ORDISCAN_API_KEY

  • Аутентификация использует формат токена Bearer

  • Все запросы включают заголовок Authorization: Bearer <your-api-key>

  • Недействительные или отсутствующие ключи API приведут к ошибкам аутентификации.

Настраивать

  1. Установите зависимости:

npm install

  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, принадлежащие адресу Bitcoin

  • Базовые и подробные инструменты для создания надписей : получение информации о надписях для адреса

  • Инструмент балансировки рун : получение баланса рун для адреса

  • Инструмент балансировки BRC-20 : получите баланс токенов BRC-20 для адреса

  • Инструмент 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. Инструменты Sat (3)

  • Инструмент информации о спутнике : получение информации о конкретном спутнике

  • Инструмент UTXO Rare Sats : получите редкие саты в UTXO.

  • Инструмент UTXO Sat Ranges : Получите диапазоны спутников в UTXO

Примеры инструментов

Инструмент информации о надписи

Получите подробную информацию о конкретной надписи.

Имя инструмента: ordiscan_inscription_info

Параметры:

  • id (строка): Идентификатор надписи (например, b61b0172d95e266c18aea0c624db987e971a5d6d4ebc2aaed85da4642d635735i0)

  • apiKey (строка, необязательно): Ваш ключ API Ordiscan

Пример ответа:

{ "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 (строка, необязательно): Ваш ключ API Ordiscan

Пример ответа:

{ "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 (строка): уникальный тик токена

  • apiKey (строка, необязательно): Ваш ключ API Ordiscan

Пример ответа:

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

  • Ошибки сетевых запросов

  • Неверная проверка ввода

  • Ограничение скорости ответов от API Ordiscan

  • Подробные сообщения об ошибках

Форматирование ответа

Каждый инструмент предоставляет как необработанные, так и отформатированные ответы:

  • Необработанные данные в поле data

  • Форматированные данные, удобные для чтения человеком, в formatted поле

  • Единый формат ошибок для всех инструментов

  • Правильное форматирование чисел и локализация даты

Рекомендации по безопасности

Управление ключами API

  • Никогда не задавайте ключи API в коде жестко

  • Используйте переменные среды для хранения ключей API

  • Периодически меняйте ключи API

  • Используйте разные ключи API для разработки и производства

Обработка ошибок

На сервере реализована безопасная обработка ошибок:

  • В сообщениях об ошибках нет конфиденциальной информации.

  • Правильные коды статуса HTTP

  • Структурированные ответы на ошибки

  • Регистрация ошибок без раскрытия внутренних компонентов

Проверка входных данных

Все инструменты используют строгую проверку входных данных:

  • Проверка схемы Zod для всех параметров

  • Проверка типов с помощью TypeScript

  • Гибкая обработка чисел для числовых вводов

  • Проверка строк для перечисляемых значений

Ограничение скорости

Ограничение скорости осуществляется с помощью API Ordiscan:

  • Дополнительное ограничение скорости не требуется

  • Ограничения скорости на основе ключей API

  • Правильные ответы на ошибки при превышении лимита скорости

  • Автоматическая обработка ограничения скорости

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.

Реализация HTTP-сервера, обеспечивающая прямой доступ к API Ordiscan с 29 интегрированными инструментами для порядковых номеров биткойнов, надписей, рун, токенов BRC-20 и редких спутниковых данных.

  1. Функции
    1. API-подключение и аутентификация
      1. Прямое подключение
      2. Аутентификация
    2. Настраивать
      1. Структура проекта
        1. Обработка параметров
          1. Гибкая обработка номеров
          2. Гибкая обработка перечислений
        2. Доступные инструменты (всего 29)
          1. 1. Основной инструмент
          2. 2. Адресные инструменты (6)
          3. 3. Инструменты для занятий (3)
          4. 4. Инструменты транзакций (4)
          5. 5. Инструменты для надписей (4)
          6. 6. Инструменты для сбора (3)
          7. 7. Рунические инструменты (3)
          8. 8. Инструменты BRC-20 (2)
          9. 9. Инструменты Sat (3)
        3. Примеры инструментов
          1. Инструмент информации о надписи
          2. Инструмент рынка рун
          3. Информационный инструмент BRC-20
        4. Обработка ошибок
          1. Форматирование ответа
            1. Рекомендации по безопасности
              1. Управление ключами API
              2. Обработка ошибок
              3. Проверка входных данных
              4. Ограничение скорости

            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