# 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

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

```bash
cd human_design
npm install
```

### Сборка

```bash
npm run build
```

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

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

**HTTP Server (для Railway/n8n):**
```bash
npm start
```

**MCP Server (через stdio):**
```bash
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, опциональный): Долгота места рождения

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

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

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

```json
{
  "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` - Центры

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

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

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

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

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

```javascript
// 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 с прямым вызовом модуля:

```javascript
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:**
```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:

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

### Custom MCP Client

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

```javascript
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)
```

## Разработка

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

```bash
npm run dev
```

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

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

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

```bash
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:**
```bash
xcode-select --install
```

**Ubuntu/Debian:**
```bash
sudo apt-get update
sudo apt-get install build-essential python3
```

**Windows:**
Установите [Visual Studio Build Tools](https://visualstudio.microsoft.com/downloads/)

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