Xano MCP Server

Xano MCP Python SDK

Сервер MCP (Model Context Protocol) на основе Python для Xano, который позволяет помощникам ИИ, таким как Claude, напрямую взаимодействовать с вашим экземпляром Xano. Это автономная версия, оптимизированная для локального использования с Claude Desktop и другими совместимыми с MCP LLM.

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

• Простая аутентификация : подключитесь с помощью токена Xano API
• Комплексный API : запросы и манипулирование экземплярами Xano, базами данных, таблицами и записями
• Локальное развертывание : запуск в качестве локального сервера MCP для Claude Desktop или других клиентов.
• Подробное ведение журнала : устранение неполадок с помощью комплексного ведения журнала
• Портативность : работает на macOS, Windows и Linux.

🚀 Быстрый старт

1. Клонируйте этот репозиторий :
   git clone https://github.com/yourusername/xano-mcp-python.git cd xano-mcp-python
2. Установить зависимости :
   pip install -r requirements.txt
3. Настройте Claude Desktop (если используете):Отредактируйте файл конфигурации Claude Desktop:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   Добавьте эту конфигурацию:

   { "mcpServers": { "xano": { "command": "python", "args": [ "/path/to/xano-mcp-python/xano_mcp_sdk.py" ], "env": { "XANO_API_TOKEN": "your-xano-api-token" } } } }
4. Запустите скрипт установки :
   # On macOS/Linux ./install.sh # On Windows install.bat
5. Проверьте установку :
   ./test.py

💡 Примеры использования

После установки вы можете использовать его с Claude или любым помощником, совместимым с MCP. Вот несколько примеров:

• Перечислите ваши экземпляры Xano :

  Какие экземпляры Xano у меня есть?

• Проверьте таблицы базы данных :

  Покажите мне все таблицы в моем экземпляре Xano "my-instance"

• Создайте новую таблицу :

  Создайте новую таблицу с именем «products» в моем экземпляре Xano «my-instance»

• Изучите структуру таблицы :

  Какова схема таблицы «пользователи»?

• Запрос записей :

  Покажите мне первые 5 записей в таблице «пользователи»

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

Управление экземплярами

• Список экземпляров
• Получить сведения об экземпляре
• Проверить статус экземпляра

Операции с базами данных

• Список баз данных/рабочих пространств
• Получить информацию о рабочем пространстве
• Управление схемой базы данных

Операции с таблицами

• Создание, обновление, удаление таблиц
• Добавить, изменить и удалить поля
• Управление индексом

Управление записями

• Создание, чтение, обновление, удаление записей
• Массовые операции
• Сложные запросы

Операции с файлами

• Список и управление файлами
• Загрузить и скачать

API-инструменты

• Управление группами API
• Создание и настройка конечной точки API

🔧 Расширенная конфигурация

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

• XANO_API_TOKEN : Ваш токен Xano API (обязательно)
• XANO_LOG_LEVEL : Установить уровень журнала (по умолчанию: ИНФОРМАЦИЯ)
• XANO_DEFAULT_INSTANCE : экземпляр по умолчанию, используемый, если не указан

Параметры командной строки

Ведение журнала

Журналы записываются в:

• macOS: ~/Library/Logs/Claude/mcp*.log
• Windows: %APPDATA%\Claude\logs\mcp*.log

Для прямого вывода на консоль выполните:

🚨 Устранение неполадок

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

1. Проверьте журналы на наличие ошибок:
   # macOS tail -n 100 -f ~/Library/Logs/Claude/mcp*.log # Windows type "%APPDATA%\Claude\logs\mcp*.log"
2. Убедитесь, что токен API правильный и имеет соответствующие разрешения.
3. Проверьте сетевое подключение к серверам Xano
4. Убедитесь, что среда Python настроена правильно.

🤝 Вклад

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

📄 Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

🙏 Благодарности

• Xano за их превосходную платформу базы данных
• Спецификация протокола контекста модели антропогенная
• Участники и тестировщики, которые помогли усовершенствовать этот SDK