Сервер Chronos MCP

Сервер Chronos MCP 🔵

Chronos — это сервер Model Context Protocol (MCP), адаптированный для блокчейна Stellar и разработанный специально для интеграции с Claude Desktop и аналогичными приложениями ИИ. Chronos предоставляет вашему помощнику ИИ инструменты на цепочке, позволяющие оптимизировать взаимодействие с сетью Stellar.

Обзор

Chronos MCP предоставляет следующие возможности:

Подключитесь к кошелькам Stellar: безопасно подключитесь к своему кошельку с помощью секретного ключа.
Список токенов кошелька: извлечение и вывод списка всех токенов, хранящихся в кошельке Stellar.
Запрос балансов: получайте балансы XLM и других активов в режиме реального времени.
Перевод средств: легко инициируйте переводы между кошельками Stellar.

Chronos создан с возможностью расширения и работает как стандартный пакет Node.js, что позволяет легко развертывать, устанавливать и интегрировать его — аналогично другим серверам MCP, таким как base-mcp.

Функции

Интеграция со Stellar: полное взаимодействие с основной сетью Stellar через API Horizon.
Простое развертывание: опубликуйте и установите Chronos с помощью npm.
Совместимость с Claude Desktop: легкая интеграция с Claude Desktop путем обновления конфигурации сервера MCP.
Расширяемая архитектура: разработана для будущих улучшений и интеграции новых инструментов.

Предпосылки

Node.js (v14 или выше)
нпм
Учетные данные кошелька Stellar (секретный ключ для подключения)
Подключение к Интернету для взаимодействия с сетью Stellar

Установка

Вариант 1: Установка из npm (рекомендуется)

Установите Chronos глобально:

npm install -g chronos-mcp

Или используйте его напрямую с npx:

npx chronos-mcp@latest

Вариант 2: Установка из исходного кода

Клонируйте репозиторий:
git clone https://github.com/yourusername/chronos-mcp.git cd chronos-mcp
Установить зависимости:
npm install
Создайте проект:
npm run build
(Необязательно) Глобальная ссылка для более легкого доступа:
npm link

Вариант 3: Использование Docker

Вы также можете запустить Chronos MCP с помощью Docker:

Создайте образ Docker:
docker build -t chronos-mcp .
Запустите контейнер:
docker run -it --rm chronos-mcp

Более подробные инструкции по использованию Docker с Chronos MCP, включая настройку Docker Compose и интеграцию с Claude Desktop, см. в Руководстве по использованию Docker .

Чтобы проверить, работает ли ваша настройка Docker локально, следуйте пошаговым инструкциям в Руководстве по тестированию Docker . Это руководство содержит инструкции по созданию образа Docker, запуску контейнера и тестированию его функциональности.

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

Переменные среды

Chronos MCP использует переменные окружения для конфигурации, особенно для конфиденциальной информации, такой как ваш секретный ключ Stellar. Проект использует dotenv для загрузки переменных окружения из файла .env во время разработки.

Чтобы настроить переменные среды:

Создайте файл .env в корне проекта:
STELLAR_SECRET_KEY=your_stellar_secret_key STELLAR_NETWORK=mainnet
Эти переменные будут автоматически загружены при запуске приложения.

При использовании Docker вы можете предоставить переменные среды несколькими способами:

Использование флага --env-file : docker run -it --rm --env-file .env chronos-mcp
Использование директивы env_file в docker-compose.yml
Установка отдельных переменных с помощью флага -e : docker run -it --rm -e STELLAR_SECRET_KEY=your_key chronos-mcp

Конфигурация рабочего стола Клода

Чтобы использовать Chronos с Claude Desktop, обновите файл конфигурации Claude Desktop, расположенный по адресу:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Пример конфигурации для Claude Desktop:

{
<<<<<<< HEAD
  "mcpServers": {
    "stellar": {
      "command": "npx",
      "args": ["chronos-mcp@latest"],
      "env": {
        "STELLAR_NETWORK": "mainnet",
        "STELLAR_SECRET_KEY": "your_stellar_secret_key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Для интеграции Docker с Claude Desktop вы можете использовать:

{
  "mcpServers": {
    "stellar": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--env-file", "/path/to/your/.env", "chronos-mcp"],
      "env": {
        "STELLAR_NETWORK": "mainnet"
      },
      "disabled": false,
      "autoApprove": []
=======
    "mcpServers": {
        "stellar": {
            "command": "npx",
            "args": [
                "chronos-mcp@latest"
            ],
            "env": {
                "STELLAR_NETWORK": "mainnet",
                "STELLAR_SECRET_KEY": "XXXX"
            },
            "disabled": false,
            "autoApprove": []
        }
>>>>>>> b2501026b3b5ef4c512fceaf340f53b5102a57f9
    }
}

Использование

Chronos MCP предоставляет следующие инструменты через свой интерфейс MCP:

подключить_кошелек

Подключается к кошельку Stellar с помощью секретного ключа.

Пример команды:

«Подключить мой кошелек, используя секретный ключ ______»

список_токенов

Перечисляет все токены и активы в указанном кошельке Stellar.

Пример команды:

«Перечислить токены моего кошелька»

получить_балансы

Возвращает баланс XLM и любых других активов.

Пример команды:

«Какой у меня текущий баланс XLM?»

перевод_средств

Переводит средства из вашего кошелька в другой кошелек Stellar.

Параметры:

secretKey : Секретный ключ вашего кошелька.
destinationAddress : адрес кошелька получателя.
amount : сумма для перевода.
asset(необязательно) : актив для передачи (по умолчанию XLM).

Пример команды:

«Перевести 0,5 XLM на [адрес кошелька назначения]»

Тестирование

Стандартное тестирование

Для локального тестирования Chronos MCP:

npm test

Это запустит тестовый набор проекта и проверит, что ваш сервер работает так, как и ожидалось.

Тестирование Докера

Чтобы протестировать настройку Docker локально, обратитесь к Руководству по тестированию Docker для получения подробных инструкций. Руководство охватывает:

Создание образа Docker
Запуск контейнера с помощью Docker Compose
Тестирование функциональности контейнера
Устранение распространенных проблем

Вы также можете использовать прилагаемый скрипт test-client.js для тестирования контейнера Docker:

node test-client.js

Этот скрипт отправляет простой MCP-запрос в контейнер Docker и отображает ответ.

Развертывание

Chronos MCP разработан для работы в качестве стандартного пакета Node.js и может быть опубликован в npm. После публикации (например, через npm publish ) Chronos может быть установлен глобально или использоваться через npx, как и любой другой сервер MCP.

Для развертывания в производственной среде рассмотрите возможность включения Chronos в системную службу (используя systemd, launchd и т. д.) для автоматического перезапуска и мониторинга.

Расширение Хроноса

Chronos создан с учетом расширяемости. Чтобы добавить новые инструменты:

Создайте новый каталог в папке src/tools .
Реализуйте свой инструмент (включите index.ts , schemas.ts и handlers.ts ).
Экспортируйте свой инструмент в src/tools/index.ts .
Обновите файл README, добавив в него документацию и примеры вашего инструмента.
Напишите тесты, чтобы убедиться, что ваш новый инструмент работает правильно.

Лицензия

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

Внося вклад

Вклады приветствуются! Пожалуйста, посетите CONTRIBUTING.md для получения инструкций по сообщению проблем, отправке запросов на включение и других инструкций по вкладу.

──────────────────────────────────── Этот файл README разработан специально для Chronos MCP и описывает его развертывание в виде пакета Node.js, интеграцию с Claude Desktop и полный набор функций для взаимодействия с блокчейном Stellar.

Chronos MCP Server

Integrations