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.

Related MCP server: Supabase MCP Server

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

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 : экземпляр по умолчанию, используемый, если не указан

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

python xano_mcp_sdk.py --token YOUR_TOKEN --log-level DEBUG

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

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

• macOS: ~/Library/Logs/Claude/mcp*.log

• Windows: %APPDATA%\Claude\logs\mcp*.log

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

python xano_mcp_sdk.py --console-logging

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

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

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