MCP-сервер записи

Обзор

Сервер протокола контекста модели (MCP), который позволяет моделям ИИ взаимодействовать с порядковыми надписями, позволяя им отображать содержимое транзакции.

Related MCP server: MCP Bitcoin CLI

🎮 Демо

💼 Содержание

• MCP-сервер записи

  • Обзор

  • 💼 Содержание

  • 🔧 Особенности

  • 🦆 Интеграция гуся

    • Использование STDIO (локальное расширение)

      • Использование SSE (удалённое расширение)

  • 🔑 Интеграция с рабочим столом Клода

    • Тестирование интеграции Claude Desktop

  • 📂 Структура проекта

  • 📦 Настройка разработки

  • 📦 Доступные инструменты

    • show_ordinals

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

  • 🤝 Вклад

  • 📝 Лицензия

🔧 Особенности

• Порядковое определение : автоматическое обнаружение и анализ транзакций Bitcoin в порядковые номера, поддержка текстовых, графических, json и других форматов надписей.

🦆 Интеграция гуся

Goose — это фреймворк агента ИИ с открытым исходным кодом от Block, который поддерживает расширения через Model Context Protocol. Вы можете интегрировать сервер MCP-Inscription как расширение Goose, чтобы Goose мог взаимодействовать с Ordinals Inscriptions. Goose поддерживает два режима интеграции для серверов MCP: запуск сервера как локального процесса (STDIO) или подключение к нему как удаленной службы через Server-Sent Events (SSE). Ниже приведены инструкции для обоих методов:

Использование STDIO (локальное расширение)

Этот метод запускает сервер MCP-Inscription локально как подпроцесс Goose, взаимодействуя через стандартный ввод/вывод.

1. Клонируйте и соберите репозиторий MCP-Inscription (если вы еще этого не сделали):

   git clone https://github.com/Laz1mov/mcp-inscription
   cd mcp-inscription
   npm install
   npm run build

   Запишите полный абсолютный путь к репозиторию, так как он понадобится вам на следующем шаге.

2. Добавьте новое расширение в Goose: Откройте интерфейс конфигурации Goose. Это можно сделать через командную строку, запустив goose configure , или в приложении Goose Desktop, перейдя в Настройки > Расширения . В меню выберите «Добавить расширение». ( Использование расширений | goose )

3. Выберите тип расширения — Расширение командной строки: при появлении запроса на выбор типа расширения выберите Расширение командной строки (в меню CLI или пользовательском интерфейсе), чтобы Goose знал, что ему следует запустить локальную команду ( Использование расширений | goose ) (в отличие от встроенного или удаленного расширения).

4. Введите данные расширения: Укажите имя и команду для сервера MCP-Inscription:

   • ID : mcp-inscription

   • Имя: Вы можете назвать его «mcp-inscription» или любым другим идентификатором (это будет то, как вы будете называть расширение).

   • Команда: Укажите полный путь к созданному скрипту CLI. Например:

     node /absolute/path/to/mcp-inscription/build/cli.js

     Замените /absolute/path/to/mcp-inscription на фактический путь к месту, куда вы клонировали репозиторий.

   • Обычно вам не нужно добавлять никаких аргументов за пределами пути скрипта (если только ваш сервер не требует специальных флагов).

5. Завершить и включить: завершить добавление расширения. Goose добавит это новое расширение в свою конфигурацию (обычно ~/.config/goose/config.yaml ). Убедитесь, что расширение включено (если используется мастер CLI, оно должно быть включено по умолчанию после добавления; в приложении Goose Desktop вы можете проверить список расширений и включить его, если это еще не сделано ( Использование расширений | goose ) ( Использование расширений | goose )).

6. Запустите сеанс Goose с новым расширением: Теперь вы можете использовать расширение в Goose. Если вы запускаете Goose через CLI, запустите сеанс, включающий расширение, выполнив:

   goose session --with-extension "mcp-inscription"

замените «ordinals» на любое имя, которое вы дали расширению ( Использование расширений | goose ). (Это гарантирует, что сеанс загрузит расширение. В качестве альтернативы, если расширение включено глобально, Goose Desktop или CLI автоматически сделают его доступным во всех сеансах.)

Использование SSE (удалённое расширение)

Этот метод подключает Goose к уже работающему серверу MCP через поток HTTP SSE. Используйте его, если вы хотите запустить сервер MCP-Inscription как автономную службу (возможно, на другой машине или просто независимо от Goose).

1. Запустите сервер MCP как автономную службу: Запустите сервер MCP-Inscription в режиме SSE для прослушивания подключений:

   # Navigate to your mcp-inscription directory
   cd /path/to/mcp-inscription
   
   # If you havent built it yet
   npm install
   npm run build
   
   # Run in SSE mode on port 3000 (default)
   SERVER_MODE=sse node build/cli.js
   
   # Alternatively, specify a different port
   SERVER_MODE=sse PORT=9000 node build/cli.js

   Это запустит сервер в режиме SSE и сделает его доступным по адресу http://localhost:3000 (или по указанному вами порту).

2. Добавьте новое расширение в Goose (удалённо): как и прежде, запустите goose configure или используйте Goose UI для добавления расширения ( Using Extensions | goose ). На этот раз выберите Remote Extension , когда вас попросят указать тип расширения ( Using Extensions | goose ). Это сообщит Goose, что он будет подключаться к внешнему серверу через SSE.

3. Введите данные удаленного расширения: дайте расширению имя (например, "ordinals") и укажите URL сервера. Для URL введите базовый адрес, по которому работает сервер MCP. Например, если ваш сервер прослушивает порт 9000 на локальной машине, вы можете ввести http://localhost:9000 . Goose попытается подключиться к конечной точке SSE сервера MCP по этому адресу. (Goose использует стандартный путь MCP SSE, который по соглашению находится под маршрутом /mcp/sse на сервере, вам обычно нужно просто указать хост и порт, а Goose сделает все остальное.)

4. Включите расширение: После добавления удаленного расширения убедитесь, что оно включено в настройках Goose (как и в случае STDIO). Необходимо включить только одно из расширений STDIO или SSE (с теми же инструментами) — если вы случайно включили и локальную, и удаленную версию одного и того же сервера, вы можете отключить одно из них, чтобы избежать путаницы.

Использование расширения MCP-Inscription в Goose: После настройки расширения (с помощью любого из указанных выше методов) и его включения вы можете взаимодействовать с Goose и запрашивать данные ord через него. В новом чате или сеансе Goose просто задавайте вопросы, как обычно. Goose распознает, когда использовать инструменты MCP-Inscription для выполнения вашего запроса. Например:

• «Покажите мне порядковые номера: 0169d12c4edf2026a67e219c10207438a080eb82d8f21860f6784dd66f281389?»

Когда вы зададите эти вопросы, Goose вызовет инструменты сервера MCP-Inscription и вернет ответ (например, информацию о последнем блоке Bitcoin). Вы должны увидеть, как Goose отвечает актуальной информацией, извлеченной из блокчейна Bitcoin через сервер MCP-Inscription.

Если Goose, похоже, не использует расширение (например, если он отвечает, что не может найти информацию), убедитесь, что расширение включено и что сервер запущен (в режиме SSE для удаленного доступа). Вы также можете запустить CLI Goose с подробным протоколированием, чтобы увидеть, пытался ли он вызвать расширение. Как правило, если настроен правильно, Goose автоматически обнаружит возможности сервера MCP-Inscription и использует их при необходимости.

Дополнительные ресурсы: Для получения более подробной информации о расширениях Goose и MCP обратитесь к официальной документации Goose ( Использование расширений | goose ). Документация включает список встроенных и созданных сообществом расширений и объясняет, как серверы MCP интегрируются в Goose. Вы также можете найти каталог доступных серверов MCP и дополнительные советы по настройке в документации Goose и документации Model Context Protocol. Это может помочь, если вы хотите изучить больше расширений или разработать свои собственные.

🔑 Интеграция с рабочим столом Клода

Чтобы использовать сервер MCP-Inscription с Claude Desktop (настольное приложение Anthropic для Claude), выполните следующие действия:

1. Загрузите и установите Claude Desktop: Посетите официальную страницу загрузок Claude Desktop и получите приложение для вашей операционной системы (macOS или Windows) ( Установка Claude для рабочего стола | Справочный центр Anthropic ). Установите приложение и убедитесь, что вы используете последнюю версию (вы можете проверить наличие обновлений в меню приложения).

2. Клонируйте и создайте репозиторий MCP-Inscription:

   git clone https://github.com/Laz1mov/mcp-inscription
   cd mcp-inscription
   npm install
   npm run build

3. Настройте Claude Desktop для использования сервера MCP-Inscription: Откройте файл конфигурации Claude Desktop (он создается при первом редактировании настроек в Claude Desktop):

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
     Добавьте запись для сервера MCP-Inscription в эту конфигурацию JSON в разделе "mcpServers" . Например:

   {
     "mcpServers": {
       "mcp-inscription": {
         "command": "node",
         "args": ["/absolute/path/to/mcp-inscription/build/cli.js"]
       }
     }
   }

   В приведенном выше фрагменте "mcp-inscription" — это идентификатор сервера (вы можете назвать его как хотите). Замените /absolute/path/to/mcp-inscription на фактический полный путь к месту, куда вы клонировали репозиторий.

4. Перезапустите Claude Desktop: сохраните файл claude_desktop_config.json , а затем закройте и снова откройте Claude Desktop . При следующем запуске Claude автоматически запустит сервер MCP-Inscription в соответствии с настройками. Если Claude Desktop был запущен, вам необходимо перезапустить его, чтобы изменения вступили в силу.

Тестирование интеграции Claude Desktop

После перезапуска Claude Desktop вы можете проверить правильность работы сервера MCP-Inscription:

• Проверьте ответ: Клод должен вернуть подробный ответ (например, саму надпись или информацию о рунах) без ошибок. Если вы получили сообщение об ошибке или не получили полезного ответа, возможно, сервер MCP не подключен должным образом.

• Проверьте журналы Клода (при необходимости): Claude Desktop предоставляет файлы журналов, которые могут помочь в отладке интеграции MCP. Если инструмент не отвечает, проверьте файлы журналов в:

  • macOS: ~/Library/Logs/Claude/

  • Windows: %APPDATA%\Claude\logs\
    Найдите mcp.log для общих сообщений о подключении MCP и файл с именем mcp-server-mcp-inscription.log (или с любым другим именем, которое вы использовали) для вывода/ошибок сервера MCP. Эти журналы покажут, был ли запущен сервер или были ли какие-либо ошибки (например, неправильный путь или исключения на сервере). Если вы видите ошибки, исправьте конфигурацию или среду по мере необходимости, затем перезапустите Claude Desktop и повторите тестирование.

Установка через Smithery

Чтобы автоматически установить Inscription Server для Claude Desktop через Smithery :

npx -y @smithery/cli install @Laz1mov/mcp-inscription --client claude

📂 Структура проекта

mcp-inscription/
├── src/
│   ├── ordinals_client.ts      # Bitcoin ordinals and runestone utility functions
│   ├── servers/
│   │   ├── index.ts            # Server exports and factory functions
│   │   ├── sse.ts              # Server implementation using SSE transport
│   │   ├── stdio.ts            # Server implementation using STDIO transport
│   │   └── base.ts             # Base server implementation with shared functionality
│   ├── index.ts                # Main entry point
│   ├── cli.ts                  # CLI launcher
│   ├── mcp_inscription_types.ts # Shared types and schemas for the MCP-Inscription server
│   └── utils/
│       ├── logger.ts           # Logger setup
│       ├── cache.ts            # Caching implementation
│       ├── error_handlers.ts   # Error handling utilities
│       ├── json_utils.ts       # JSON processing utilities
│       ├── img_utils.ts        # Image processing and conversion utilities
│       └── version.ts          # Version information
├── .env.example                # Example environment configuration file
├── package.json
├── tsconfig.json
└── README.md

📦 Доступные инструменты

show_ordinals

Описание:
Декодирует данные порядковой надписи из данных свидетеля транзакции.

Схема ввода:

{
  "txid": "string"
}

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

{
  "txid": "0169d12c4edf2026a67e219c10207438a080eb82d8f21860f6784dd66f281389"
}

Выход:
Возвращает декодированное содержимое надписи, которое может быть текстом, JSON, HTML или другими форматами.

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

Сервер использует пользовательские типы ошибок для обработки операций Bitcoin и запросов блокчейна. Подробные сообщения об ошибках регистрируются с помощью Pino и включаются в ответы клиентов для упрощения отладки.

🤝 Вклад

Приветствуются ваши вклады и запросы на функции! Не стесняйтесь отправлять запросы на включение или открывать проблемы на GitHub.

📝 Лицензия

Данный проект лицензирован по лицензии MIT .