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

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

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

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

Related MCP server: Solana MCP Server

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

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

monad-mcp-server/
├── .env.example        # Example environment variables file
├── .gitignore          # Specifies intentionally untracked files that Git should ignore
├── LICENSE             # Project's software license
├── README.md           # This file, providing an overview and instructions
├── package-lock.json   # Records the exact versions of dependencies
├── package.json        # Lists project dependencies and scripts
├── pnpm-lock.yaml      # PNPM lockfile for dependency resolution
├── src/                # Source code directory
│   ├── config/         # Configuration files
│   │   └── server.ts   # Server setup and Viem client initialization
│   ├── index.ts        # Main entry point of the application
│   └── tools/          # MCP tools for interacting with Monad
│       ├── block/      # Tools related to blockchain blocks (e.g., get-latest-block)
│       ├── contract/   # Tools for smart contract interactions (e.g., deploy, watch events)
│       ├── nft/        # Tools for Non-Fungible Tokens (e.g., query-mon-nft)
│       └── wallet/     # Tools for wallet operations (e.g., get balance, send transactions)
└── tsconfig.json       # TypeScript compiler configuration

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

• 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), вам нужно добавить его конфигурацию в настройки клиента. Точный метод может различаться в зависимости от клиента, но обычно включает указание способа запуска сервера.

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

{
  "mcpServers": {
    // ... other server configurations ...
    "monad-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/your/project/monad-mcp-server/build/index.js"
      ],
      "env": {
        "PRIVATE_KEY": "<your_monad_private_key_if_not_using_dotenv_or_to_override>"
      }
    }
    // ... other server configurations ...
  }
}

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

• "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, его настройки и использования.