Skip to main content
Glama
Human Design MCP Server

Human Design MCP Server

by dvvolkovv

Human Design MCP Server

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

Описание

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

  • Определение типа (Manifestor, Generator, Manifesting Generator, Projector, Reflector)

  • Вычисление стратегии и авторитета

  • Расчет профиля

  • Определение активных ворот (gates) и их линий

  • Определение определенных центров

  • Расчет Incarnation Cross

Related MCP server: Astrology MCP Server

Установка

Требования

  • 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 для детальной информации о установке.

Available Tools

2 tools
calculate_human_designC

Рассчитывает карту Human Design по дате, времени и месту рождения

Inputs: birthDate (required), birthTime (required), birthLocation (required), latitude, +1 more.

get_human_design_definitionC

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

Inputs: component (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one calculates a Human Design chart from birth data, while the other retrieves definitions and meanings. There is no overlap or ambiguity between these functions.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern (calculate_human_design and get_human_design_definition), using snake_case and clear action verbs that align with their functions.

    Tool Count2/5

    With only two tools, the server feels thin for the Human Design domain, which typically involves multiple components like centers, gates, profiles, and types. A more comprehensive set would include tools for interpreting or analyzing specific aspects beyond just calculation and definitions.

    Completeness2/5

    The tool surface is significantly incomplete for Human Design. It lacks tools for key operations such as interpreting chart components (e.g., centers, channels), generating reports, or comparing charts, which are essential for practical use in this domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Calculates Chinese BaZi (Four Pillars of Destiny) charts based on birth date, time, and location, including solar term information, decade luck cycles, and true solar time corrections.
      2
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Calculates astrological birth charts including planetary positions, house placements, and aspects based on birth date, time, and location.
      2,495 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Calculates astrological natal charts with high precision using Swiss Ephemeris, supporting multiple house systems and location inputs.
      2
      28 npm
      5
      AGPL 3.0