Сервер MCP, созданный с помощью Ping Agent Kit

Сервер Model Context Protocol (MCP), предлагающий onchain-инструменты для ИИ, обеспечивающий бесшовное взаимодействие с блокчейном Solana через стандартизированный интерфейс. Эта реализация, созданная на основе Ping Agent Kit, позволяет агентам ИИ эффективно выполнять операции блокчейна.

Обзор

Этот сервер MCP расширяет возможности Клода, предоставляя инструменты для:

• Взаимодействие с блокчейном Solana

• Выполнение транзакций

• Запрос информации об учетной записи

• Управляйте кошельками Solana

Сервер реализует спецификацию Model Context Protocol для стандартизации взаимодействия блокчейна для агентов ИИ.

Related MCP server: Solana MCP Server

Предпосылки

• Node.js (v16 или выше)

• pnpm (рекомендуется), npm или пряжа

• Кошелек Solana с закрытым ключом

• URL-адрес Solana RPC (основная сеть, тестовая сеть или devnet)

Установка

Вариант 1: Установка из npm (рекомендуется для таких клиентов, как Cursor/Cline)

# Install globally
npm install -g ping-mcp

# Or install locally in your project
npm install ping-mcp

Вариант 2: Сборка из исходного кода

1. Клонируйте этот репозиторий:

git clone https://github.com/PingAIFun/ping-mcp.git
cd ping-mcp

2. Установить зависимости:

pnpm install

3. Создайте проект:

pnpm run build

Конфигурация

Настройка среды

Создайте файл .env с вашими учетными данными:

# Solana Configuration
SOLANA_PRIVATE_KEY=your_private_key_here
RPC_URL=your_solana_rpc_url_here
OPENAI_API_KEY=your_openai_api_key # OPTIONAL

Интеграция с Claude Desktop

Чтобы добавить этот MCP-сервер в Claude Desktop, выполните следующие действия:

1. Найдите файл конфигурации рабочего стола Claude.

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

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Добавьте конфигурацию. Создайте или отредактируйте файл конфигурации и добавьте следующий JSON:

   Если вы установили через npm (Вариант 1):

   {
     "mcpServers": {
       "solana-mcp": {
         "command": "npx",
         "args": ["ping-mcp"],
         "env": {
           "RPC_URL": "your_solana_rpc_url_here",
           "SOLANA_PRIVATE_KEY": "your_private_key_here",
           "OPENAI_API_KEY": "your_openai_api_key"  // OPTIONAL
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }

   Если вы собрали из исходников (Вариант 2):

   {
     "mcpServers": {
       "solana-mcp": {
         "command": "node",
         "args": ["/path/to/ping-mcp/build/index.js"],
         "env": {
           "RPC_URL": "your_solana_rpc_url_here",
           "SOLANA_PRIVATE_KEY": "your_private_key_here",
           "OPENAI_API_KEY": "your_openai_api_key"  // OPTIONAL
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }

3. Перезапустите Claude Desktop. После внесения этих изменений перезапустите Claude Desktop, чтобы конфигурация вступила в силу.

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

ping-agent-kit-mcp/
├── src/
│   ├── index.ts          # Main entry point
├── package.json
└── tsconfig.json

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

Сервер MCP предоставляет следующие инструменты блокчейна Solana:

• GET_ASSET — получение информации об активе/токене Solana

• DEPLOY_TOKEN — Развертывание нового токена на Solana

• GET_PRICE — получение информации о ценах на токены

• WALLET_ADDRESS - Получить адрес кошелька

• BALANCE - Проверьте баланс кошелька

• TRANSFER - Передача токенов между кошельками

• MINT_NFT — создание и выпуск новых NFT

• TRADE - Осуществляйте торговлю токенами

• REQUEST_FUNDS — Запрос средств (полезно для тестирования/разработки)

• RESOLVE_DOMAIN - Разрешение доменных имен Solana

• GET_TPS — получить текущие транзакции в секунду на Solana

Соображения безопасности

• Храните свой закрытый ключ в безопасности и никогда не делитесь им

• Используйте переменные среды для конфиденциальной информации

• Рассмотрите возможность использования специального кошелька для операций ИИ-агента.

• Регулярно контролируйте и проверяйте действия агентов ИИ

• Тестовые операции в devnet/testnet перед mainnet

Поиск неисправностей

Если у вас возникли проблемы:

1. Проверьте правильность вашего закрытого ключа Solana

2. Проверьте доступность вашего RPC URL

3. Убедитесь, что вы находитесь в нужной сети (mainnet, testnet или devnet)

4. Проверьте журналы Claude Desktop на наличие сообщений об ошибках.

5. Убедитесь, что сборка прошла успешно.

Зависимости

Ключевые зависимости включают в себя:

• @solana/web3.js

• @modelcontextprotocol/sdk

• ping-агент-комплект

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

1. Форк репозитория

2. Создайте ветку функций ( git checkout -b feature/amazing-feature )

3. Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )

4. Отправить в ветку ( git push origin feature/amazing-feature )

5. Открыть запрос на извлечение

Лицензия

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