Human Design MCP Server

# Human Design с Swiss Ephemeris ## Описание Проект использует Swiss Ephemeris для точных расчетов Human Design карты. ## Установка Swiss Ephemeris ### Автоматическая установка ```bash npm install ``` Swiss Ephemeris установится автоматически как зависимость. ### Требования для компиляции Swiss Ephemeris требует компиляции нативных модулей. Убедитесь, что установлены: #### macOS ```bash xcode-select --install ``` #### Ubuntu/Debian ```bash sudo apt-get update sudo apt-get install build-essential node-gyp python3 ``` #### Fedora/RHEL ```bash sudo dnf groupinstall "Development Tools" sudo dnf install node-gyp python3 ``` #### Windows Установите [Visual Studio Build Tools](https://visualstudio.microsoft.com/downloads/) или [Visual Studio Community](https://visualstudio.microsoft.com/vs/community/). ## Запуск ### HTTP Server (для Railway/n8n) ```bash npm start # или npm run dev ``` ### MCP Server через stdio ```bash npm run start:mcp # или npm run dev:mcp ``` ## Характеристики | Параметр | Значение | |----------|----------| | Скорость | ⚡⚡ Средне (~50-100ms на расчет) | | Точность | 🎯 100% | | Расчет планет | Реальные позиции из Swiss Ephemeris | | Ворота | Точные позиции Human Design | | Готовность к production | ✅ Да | ## Пример использования ### Через MCP ```bash # HTTP Server echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"calculate_human_design","arguments":{"birthDate":"1990-05-15","birthTime":"14:30","birthLocation":"Москва"}}}' | npm start # MCP Server через stdio echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"calculate_human_design","arguments":{"birthDate":"1990-05-15","birthTime":"14:30","birthLocation":"Москва"}}}' | npm run start:mcp ``` ### Через прямую интеграцию ```javascript const { calculateHumanDesign } = require('./src/calculations-cjs.cjs'); const result = await calculateHumanDesign({ birthDate: '1990-05-15', birthTime: '14:30', birthLocation: 'Москва, Россия', latitude: 55.7558, longitude: 37.6173 }); ``` ## Пример результата ```json { "gates": [ { "planet": "Sun", "gate": 19, "line": 2, "name": "Approach", "ru_name": "Подход", "sign": 1, "hexagram": 19, "longitude": 19.45 } ], "calculationSource": "Swiss Ephemeris", "version": "1.0.0-full" } ``` ## Интеграция с n8n ### Вариант 1: Используйте прямо в Code Node ```javascript // В n8n Code Node const { calculateHumanDesign } = require('/path/to/human_design/src/calculations-cjs.cjs'); const result = await calculateHumanDesign({ birthDate: $input.item.json.birthDate, birthTime: $input.item.json.birthTime, birthLocation: $input.item.json.birthLocation, }); return { json: result }; ``` ### Вариант 2: HTTP API Создайте отдельный сервер: ```javascript // api-server.js const express = require('express'); const { calculateHumanDesign } = require('./src/calculations-cjs.cjs'); const app = express(); app.use(express.json()); app.post('/api/human-design', async (req, res) => { try { const result = await calculateHumanDesign(req.body); res.json({ success: true, data: result }); } catch (error) { res.status(500).json({ success: false, error: error.message }); } }); app.listen(3000, () => { console.log('API server running on http://localhost:3000'); }); ``` Запустите: ```bash node api-server.js ``` ## Решение проблем ### Ошибка: Cannot find module 'swisseph' ```bash npm install swisseph # или переустановите все зависимости rm -rf node_modules package-lock.json npm install ``` ### Ошибка: node-gyp rebuild failed Установите build tools для вашей системы (см. раздел "Требования для компиляции"). ### Ошибка: swisseph.node is not a valid Win32 application Это означает, что модуль скомпилирован для другой платформы. Переустановите: ```bash npm rebuild swisseph ``` ### Ошибка в n8n: require is not defined Для n8n используйте HTTP API через Railway или dynamic import: ```javascript const swissephModule = await import('/path/to/human_design/src/calculations-cjs.cjs'); const { calculateHumanDesign } = swissephModule.default || swissephModule; ``` Для удобства используйте Railway HTTP API (рекомендуется). ## Производительность - **Swiss Ephemeris**: ~50-100ms на расчет - Для большинства случаев это приемлемо ## Рекомендации - **Для Railway**: используйте деплой на Railway (автоматическая сборка) - **Для n8n**: используйте HTTP API через Railway - **Для локального использования**: убедитесь что установлены build tools - **Для Docker**: обязательно установите build tools в образе ## Docker пример ```dockerfile FROM node:18 WORKDIR /app # Установите build tools RUN apt-get update && apt-get install -y build-essential python3 COPY package*.json ./ RUN npm install COPY . . CMD ["npm", "start"] ``` ## Дополнительная информация - [Swiss Ephemeris документация](https://www.astro.com/swisseph/swephinfo_e.htm) - [Swiss Ephemeris npm package](https://www.npmjs.com/package/swisseph) - [Human Design System](https://www.humandesign.me/)