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:

1. Webhook Trigger для входящих запросов
2. Function Node с расчетом Human Design
3. 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 для детальной информации о установке.