Human Design MCP Server
This server calculates Human Design charts and provides definitions for Human Design components using Swiss Ephemeris for precise astronomical calculations.
Core Capabilities:
Calculate Human Design Charts: Generate complete charts using birth date, time, and location (with optional latitude/longitude coordinates for enhanced precision). Calculations include:
Type (Manifestor, Generator, Manifesting Generator, Projector, or Reflector)
Strategy and Authority for decision-making
Profile numbers describing life themes
Active Gates with their lines and associated planets
Defined Centers in the bodygraph
Incarnation Cross based on Sun and Earth gate positions
Get Human Design Definitions: Retrieve detailed explanations for:
Types, Authorities, and Profiles
Gates (all 64), Channels, and Centers (all 9)
Integration Options:
n8n: Via HTTP Request Node, Function Node, or Sub-workflow
Claude Desktop: As an MCP (Model Context Protocol) server
HTTP REST API: Port 3000 for Railway or other cloud platforms
stdio-based MCP server: For custom MCP clients and compatible systems
Provides Human Design chart calculations that can be integrated into n8n workflows through HTTP wrapper server, Function Nodes, or sub-workflows for automated birth chart analysis and processing.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Human Design MCP Server calculate my Human Design chart for May 15, 1990 at 2:30 PM in Moscow"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 startMCP Server (через stdio):
npm run start:mcp📚 Сервер использует Swiss Ephemeris для точных расчетов
HTTP сервер работает на порту 3000 (или PORT из env) и готов принимать запросы.
Инструменты сервера
1. calculate_human_design
Рассчитывает полную карту Human Design.
Параметры:
birthDate(string, обязательный): Дата рождения в формате YYYY-MM-DDbirthTime(string, обязательный): Время рождения в формате HH:MMbirthLocation(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 Designauthority- Авторитеты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/calculateBody:
{"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 --installUbuntu/Debian:
sudo apt-get update
sudo apt-get install build-essential python3Windows: Установите Visual Studio Build Tools
См. SWISS_EPHEMERIS.md для детальной информации о установке.
Available Tools
2 toolscalculate_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
Scored across 2 tools
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.
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.
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.
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
Related MCP Connectors
Calculate Human Design charts, follow transits and forecasts, compare people and analyse groups.
Human Design chart from a birth date, time and time zone: type, authority, profile, centers.
Human Design charts, transits and connections from birth data, explained in EN, NL and DE.
Human Design bodygraph, type, authority, profile, gates and channels for AI agents.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceCalculates 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-
- AlicenseNot gradedqualityDmaintenanceCalculates astrological birth charts including planetary positions, house placements, and aspects based on birth date, time, and location.2,495 npm1MIT
- AlicenseNot gradedqualityCmaintenanceCompute Human Design charts, cycle returns, transits, synthesis, and chart comparison natively inside AI assistants.12 npm2MIT
- AlicenseAqualityDmaintenanceCalculates astrological natal charts with high precision using Swiss Ephemeris, supporting multiple house systems and location inputs.228 npm5AGPL 3.0