Human Design MCP Server

MCP Server для расчета карты Human Design по дате, времени и месту рождения. Совместим с n8n и другими системами, поддерживающими Model Context Protocol.

Описание

Этот сервер предоставляет инструменты для расчета Human Design карты, включая:

Определение типа (Manifestor, Generator, Manifesting Generator, Projector, Reflector)
Вычисление стратегии и авторитета
Расчет профиля
Определение активных ворот (gates) и их линий
Определение определенных центров
Расчет Incarnation Cross

Установка

Требования

Node.js >= 18.0.0
npm или yarn

Установка зависимостей

cd human_design npm install

Сборка

npm run build

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

Запуск сервера

HTTP Server (для Railway/n8n):

npm start

MCP Server (через stdio):

npm run start:mcp

📚 Сервер использует Swiss Ephemeris для точных расчетов

HTTP сервер работает на порту 3000 (или PORT из env) и готов принимать запросы.

Инструменты сервера

1. calculate_human_design

Рассчитывает полную карту Human Design.

Параметры:

birthDate (string, обязательный): Дата рождения в формате YYYY-MM-DD
birthTime (string, обязательный): Время рождения в формате HH:MM
birthLocation (string, обязательный): Место рождения (город, страна)
latitude (number, опциональный): Широта места рождения
longitude (number, опциональный): Долгота места рождения

Пример запроса:

{ "name": "calculate_human_design", "arguments": { "birthDate": "1990-05-15", "birthTime": "14:30", "birthLocation": "Москва, Россия", "latitude": 55.7558, "longitude": 37.6173 } }

Пример ответа:

{ "birthDate": "1990-05-15", "birthTime": "14:30", "birthLocation": "Москва, Россия", "type": { "name": "Generator", "description": "Генератор" }, "strategy": "Отвечать", "authority": { "name": "Sacral", "description": "Сакральная авторитет" }, "profile": { "number": "3/5", "description": "Профиль 3/5" }, "gates": [ { "number": 19, "name": "Approach", "line": 2, "planet": "Sun" }, { "number": 49, "name": "Revolution", "line": 4, "planet": "Earth" } ], "definedCenters": [ { "number": 2, "name": "Sacral Center" } ], "incarnationCross": { "sunGate": 19, "earthGate": 19, "cross": "Cross of 19 / 19" } }

2. get_human_design_definition

Получить определения и значения компонентов Human Design.

Параметры:

component (string, обязательный): Компонент для определения
- type - Типы Human Design
- authority - Авторитеты
- profile - Профили
- gates - Ворота
- channels - Каналы
- centers - Центры

Пример запроса:

{ "name": "get_human_design_definition", "arguments": { "component": "type" } }

Интеграция с n8n

Метод 1: Использование HTTP Request Node

Создайте веб-обертку для MCP сервера:

// wrapper-server.js import express from 'express'; import { spawn } from 'child_process'; import readline from 'readline'; const app = express(); app.use(express.json()); app.post('/calculate', async (req, res) => { const mcpServer = spawn('node', ['index.js']); const rl = readline.createInterface({ input: mcpServer.stdout, output: mcpServer.stdin, }); // Отправка MCP запроса const request = { jsonrpc: '2.0', id: 1, method: 'tools/call', params: { name: 'calculate_human_design', arguments: req.body, }, }; mcpServer.stdin.write(JSON.stringify(request) + '\n'); // Чтение ответа rl.once('line', (response) => { const result = JSON.parse(response); res.json(result.result); }); }); app.listen(3000, () => { console.log('MCP wrapper server running on port 3000'); });

Затем используйте в n8n HTTP Request Node:

Method: POST
URL: http://localhost:3000/calculate
Body: {"birthDate": "...", "birthTime": "...", "birthLocation": "..."}

Метод 2: Использование Function Node в n8n

В n8n используйте Function Node с прямым вызовом модуля:

const { calculateHumanDesign } = require('/path/to/human_design/src/calculations.js'); // Получить данные из предыдущего узла const birthDate = $input.item.json.birthDate; const birthTime = $input.item.json.birthTime; const birthLocation = $input.item.json.birthLocation; // Рассчитать Human Design const result = await calculateHumanDesign({ birthDate, birthTime, birthLocation, }); return { json: { ...result, timestamp: new Date().toISOString(), } };

Метод 3: Использование Sub-workflow

Создайте отдельный workflow в n8n:

Webhook Trigger для входящих запросов
Function Node с расчетом Human Design
HTTP Response Node для отправки результата

workflow-json:

{ "name": "Human Design Calculator", "nodes": [ { "parameters": {}, "name": "Webhook", "type": "n8n-nodes-base.webhook", "position": [250, 300] }, { "parameters": { "jsCode": "const { calculateHumanDesign } = require('/path/to/human_design/src/calculations.js');\n\nconst result = await calculateHumanDesign({\n birthDate: $input.item.json.birthDate,\n birthTime: $input.item.json.birthTime,\n birthLocation: $input.item.json.birthLocation,\n});\n\nreturn { json: result };" }, "name": "Calculate HD", "type": "n8n-nodes-base.function", "position": [450, 300] }, { "parameters": {}, "name": "Respond to Webhook", "type": "n8n-nodes-base.respondToWebhook", "position": [650, 300] } ], "connections": { "Webhook": { "main": [[{ "node": "Calculate HD", "type": "main", "index": 0 }]] }, "Calculate HD": { "main": [[{ "node": "Respond to Webhook", "type": "main", "index": 0 }]] } } }

Интеграция с другими системами

Claude Desktop

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

{ "mcpServers": { "human-design": { "command": "node", "args": ["/absolute/path/to/human_design/index.js"] } } }

Custom MCP Client

Пример использования в Node.js:

import { spawn } from 'child_process'; import readline from 'readline'; const mcpServer = spawn('node', ['index.js']); const rl = readline.createInterface({ input: mcpServer.stdout, output: mcpServer.stdin, }); async function calculateHumanDesign(birthDate, birthTime, birthLocation) { const request = { jsonrpc: '2.0', id: 1, method: 'tools/call', params: { name: 'calculate_human_design', arguments: { birthDate, birthTime, birthLocation, }, }, }; mcpServer.stdin.write(JSON.stringify(request) + '\n'); return new Promise((resolve, reject) => { rl.once('line', (response) => { const result = JSON.parse(response); if (result.error) { reject(new Error(result.error.message)); } else { resolve(result.result); } }); }); } // Использование const result = await calculateHumanDesign('1990-05-15', '14:30', 'Москва, Россия'); console.log(result);

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

human_design/ ├── http-server.js # HTTP Server для Railway/n8n ├── index-with-swiss.js # MCP Server через stdio ├── package.json # Зависимости проекта ├── README.md # Документация ├── QUICKSTART.md # Быстрый старт ├── RAILWAY_DEPLOY.md # Инструкция по деплою на Railway ├── N8N_SETUP.md # Интеграция с n8n └── src/ └── calculations-cjs.cjs # Расчеты Human Design (Swiss Ephemeris)

Разработка

Запуск в режиме разработки

npm run dev

Сервер будет перезагружаться автоматически при изменении файлов.

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

Для тестирования отправьте MCP запрос:

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node index.js

Лицензия

MIT

Поддержка

Для вопросов и предложений создайте issue в репозитории проекта.

Примечания

Human Design использует тропический зодиак (не сидерический, как в ведической астрологии)
Расчеты основаны на Swiss Ephemeris для точности позиций планет
Проект использует только Swiss Ephemeris версию с точными расчетами
Требуется компиляция нативных модулей при установке

Требования для установки Swiss Ephemeris

Для компиляции Swiss Ephemeris требуются build tools:

macOS:

xcode-select --install

Ubuntu/Debian:

sudo apt-get update sudo apt-get install build-essential python3

Windows: Установите Visual Studio Build Tools

См. SWISS_EPHEMERIS.md для детальной информации о установке.

Human Design MCP Server

Human Design MCP Server

Описание

Установка

Требования

Установка зависимостей

Сборка

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

Запуск сервера

Инструменты сервера

1. calculate_human_design

2. get_human_design_definition

Интеграция с n8n

Метод 1: Использование HTTP Request Node

Метод 2: Использование Function Node в n8n

Метод 3: Использование Sub-workflow

Интеграция с другими системами

Claude Desktop

Custom MCP Client

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

Разработка

Запуск в режиме разработки

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

Лицензия

Поддержка

Примечания

Требования для установки Swiss Ephemeris

Related Resources

Tools

New MCP Servers

MCP directory API