Monad MCP Server

Монада MCP Сервер

Этот сервер MCP (Model Context Protocol) предназначен для взаимодействия с тестовой сетью Monad. Он предоставляет разработчикам набор инструментов и возможностей для взаимодействия с блокчейном Monad, включая проверку балансов токенов MON, отправку транзакций, развертывание смарт-контрактов и мониторинг событий блокчейна.

Что такое МКП?

Model Context Protocol (MCP) — это стандартизированный интерфейс, который позволяет моделям ИИ безопасно и эффективно взаимодействовать с внешними инструментами, службами и источниками данных. Этот сервер реализует MCP для предоставления функциональных возможностей блокчейна Monad совместимым агентам или приложениям ИИ.

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

Проект организован следующим образом:

Ключевые компоненты

• src/index.ts : Это главная точка входа для сервера. Она инициализирует экземпляр сервера MCP и регистрирует все доступные инструменты (кошелек, контракт, NFT, блок).
• src/config/server.ts : Этот файл управляет конфигурацией основного сервера. Он настраивает экземпляр McpServer с его именем, версией и списком возможностей. Он также инициализирует публичный клиент Viem для взаимодействия с тестовой сетью Monad и предоставляет функцию для создания клиента кошелька Viem с использованием закрытого ключа из переменных среды. Сервер использует StdioServerTransport для связи.
• src/tools/ : Этот каталог содержит реализации различных инструментов MCP. Каждый подкаталог обычно фокусируется на определенном аспекте взаимодействия Monad:
  • walletProvider : управляет балансами и транзакциями токенов MON.
  • contractProvider : управляет развертыванием смарт-контрактов и отслеживанием событий.
  • nftProvider : предоставляет функциональность для запроса NFT в сети Monad.
  • blockProvider : предлагает инструменты для получения информации о блоках.

Предпосылки

Прежде чем начать, убедитесь, что у вас установлено следующее:

• Node.js (версия 16 или более поздняя)
• Менеджер пакетов Node.js: npm , yarn или pnpm (в этом проекте в примерах используется pnpm )
• Claude Desktop (или любой MCP-совместимый клиент) для взаимодействия с сервером.

Переменные среды (.env)

Этот проект использует переменные среды для управления конфиденциальной информацией, в первую очередь закрытым ключом вашей учетной записи Monad.

1. Скопируйте файл примера : создайте копию .env.example и переименуйте ее в .env .
   cp .env.example .env
2. Редактировать .env : Откройте только что созданный файл .env в текстовом редакторе.
3. Set PRIVATE_KEY : Заполните переменную PRIVATE_KEY закрытым ключом вашего аккаунта Monad. Этот ключ необходим для таких операций, как отправка транзакций или развертывание контрактов.
   PRIVATE_KEY="0xyourprivatekeyhere"
   Важно : убедитесь, что ваш закрытый ключ начинается с 0x .
4. Безопасность : Никогда не фиксируйте свой файл .env в репозитории Git. Файл .gitignore уже настроен на предотвращение этого, но всегда помните о защите своих закрытых ключей.

Начиная

Для настройки и запуска сервера Monad MCP выполните следующие действия:

1. Клонировать репозиторий :Если вы еще этого не сделали, клонируйте проект с GitHub:
   git clone https://github.com/lispking/monad-mcp-server.git cd monad-mcp-server
2. Установить зависимости :Используйте pnpm (или предпочитаемый вами менеджер пакетов) для установки зависимостей проекта, перечисленных в package.json :
   pnpm install
3. Постройте проект :Сервер написан на TypeScript и его нужно скомпилировать в JavaScript. Запустите скрипт сборки:
   pnpm build
   Эта команда будет использовать tsc (компилятор TypeScript), как определено в package.json , для компиляции исходных файлов из каталога src в каталог build .

Теперь сервер собран и готов к использованию клиентом MCP.

Возможности сервера

Как определено в src/config/server.ts , сервер предоставляет следующие возможности:

• get-mon-balance : получение баланса токенов MON для учетной записи.
• send-mon-transaction : отправка токенов MON с одного счета на другой.
• deploy-mon-contract : Развертывание смарт-контракта в тестовой сети Monad.
• watch-contract-events : Отслеживайте и сообщайте о событиях, создаваемых определенным смарт-контрактом.
• query-mon-nft : Запрос информации о невзаимозаменяемых токенах в сети Monad.
• get-latest-block : получение сведений о самом последнем блоке в тестовой сети Monad.
• get-block-by-number : Извлечение определенного блока по его номеру.

Добавление конфигурации сервера MCP к вашему клиенту

Чтобы использовать этот сервер с клиентом, совместимым с MCP (например, Claude Desktop), вам нужно добавить его конфигурацию в настройки клиента. Точный метод может различаться в зависимости от клиента, но обычно включает указание способа запуска сервера.

Вот пример фрагмента конфигурации:

Пояснение полей конфигурации :

• "monad-mcp" : уникальное имя, которое вы назначаете этой конфигурации сервера в своем клиенте.
• "command": "node" : Указывает, что сервер является приложением Node.js.
• "args" : массив аргументов для передачи команде node .
  • Первый аргумент — это путь к скомпилированной точке входа сервера: /absolute/path/to/your/project/monad-mcp-server/build/index.js . Замените /absolute/path/to/your/project/ на фактический абсолютный путь к месту, куда вы клонировали репозиторий monad-mcp-server .
• "env" : объект для установки переменных среды для серверного процесса.
  • "PRIVATE_KEY" : Здесь вы можете задать свой закрытый ключ. Однако обычно рекомендуется использовать файл .env для лучшей безопасности. Если задать здесь, он может переопределить значение в .env в зависимости от поведения клиента и порядка загрузки переменных среды сервера.

Примечание : убедитесь, что путь в "args" указан правильно и указывает на файл build/index.js в каталоге вашего проекта.

Дополнительные ресурсы

Более подробную информацию об используемых технологиях и концепциях можно найти в следующей официальной документации:

• Документация по протоколу контекста модели (MCP)
• Документация по Монаде
• Документация Viem (Viem — клиентская библиотека Ethereum/Monad, используемая в этом проекте)

Этот подробный файл README должен обеспечить четкое понимание Monad MCP Server, его настройки и использования.