natalengine/mcp.html at main · Unforced-Dev/natalengine · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>MCP Server - NatalEngine</title>
  <meta name="description" content="Add NatalEngine to Claude and other AI assistants via Model Context Protocol.">
  <link rel="preconnect" href="https://fonts.googleapis.com">
  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
  <link rel="stylesheet" href="/src/styles.css">
  <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>%E2%97%89</text></svg>">
</head>
<body>
  <nav class="main-nav">
    <a href="./" class="nav-logo">natalengine</a>
    <div class="nav-links">
      <a href="./" class="nav-link">Calculator</a>
      <a href="./docs.html" class="nav-link">Docs</a>
      <a href="./mcp.html" class="nav-link active">MCP</a>
      <a href="https://github.com/Unforced-Dev/natal-engine" class="nav-link" target="_blank">GitHub</a>
    </div>
  </nav>

  <div class="page-container">
    <div class="page-header">
      <h1>MCP Server</h1>
      <p>Add birth chart calculation to your AI assistant</p>
    </div>

    <section class="content-section">
      <h2>What is MCP?</h2>
      <p>
        The <a href="https://modelcontextprotocol.io" target="_blank">Model Context Protocol</a> (MCP) is an open standard that allows AI assistants to connect to external tools. By adding the NatalEngine MCP server, Claude can calculate birth charts on demand.
      </p>
    </section>

    <section class="content-section">
      <h2>Quick Start</h2>

      <h3>Option 1: Install from npm</h3>
      <pre><code>npm install -g natalengine</code></pre>

      <p>Add to your Claude Code settings (<code>~/.claude/settings.json</code>):</p>
      <pre><code>{
  "mcpServers": {
    "natalengine": {
      "command": "npx",
      "args": ["natalengine-mcp"]
    }
  }
}</code></pre>

      <h3>Option 2: Clone from source</h3>
      <pre><code>git clone https://github.com/Unforced-Dev/natal-engine.git
cd natalengine
npm install</code></pre>

      <p>Add to settings:</p>
      <pre><code>{
  "mcpServers": {
    "natalengine": {
      "command": "node",
      "args": ["/path/to/natalengine/src/mcp/index.js"]
    }
  }
}</code></pre>

      <h3>Try It</h3>
      <p>Restart Claude Code and ask:</p>
      <pre><code>"Calculate my birth chart for June 15, 1990 at 2:30 PM in New York"</code></pre>
    </section>

    <section class="content-section">
      <h2>Available Tools</h2>

      <h3>calculate_natal_chart</h3>
      <p>Complete profile from all four systems (Western astrology, Vedic, Human Design, Gene Keys).</p>

      <h3>calculate_astrology</h3>
      <p>Western natal chart with planets, aspects, and analysis.</p>

      <h3>calculate_vedic</h3>
      <p>Vedic (Jyotish) chart with Lahiri ayanamsa, Nakshatras, and Vimshottari Dasha.</p>

      <h3>calculate_human_design</h3>
      <p>Type, Strategy, Authority, Profile, Gates, Channels.</p>

      <h3>calculate_gene_keys</h3>
      <p>Activation, Venus, and Pearl sequences with shadow/gift/siddhi.</p>

      <h3>get_planetary_positions</h3>
      <p>Raw astronomical data for all celestial bodies.</p>
    </section>

    <section class="content-section">
      <h2>Example Prompts</h2>
      <ul>
        <li>"What's my Human Design type if I was born March 21, 1985 at 6 AM in LA?"</li>
        <li>"Calculate the Gene Keys for December 25, 1992 at 11:30 PM in London"</li>
        <li>"Show me the aspects for August 15, 1988, 3:30 PM, Tokyo"</li>
        <li>"What's my Vedic moon sign and nakshatra for February 14, 1990, 8 AM in Mumbai?"</li>
        <li>"What are the planetary positions for July 4, 1976 at noon in Philadelphia?"</li>
      </ul>
    </section>

    <section class="content-section">
      <h2>All Local</h2>
      <p>
        All calculations run on your machine. No birth data is sent to external servers. The MCP server uses the same astronomy-engine library as the web calculator for high-precision results.
      </p>
    </section>

    <section class="content-section">
      <h2>Troubleshooting</h2>

      <h3>Server not found</h3>
      <p>Check the path in settings.json. For npx, ensure natalengine is installed globally.</p>

      <h3>Tools not appearing</h3>
      <p>Restart Claude Code. Verify the server works:</p>
      <pre><code>npx natalengine-mcp
# Should output: "NatalEngine MCP Server running on stdio"</code></pre>

      <h3>Calculation errors</h3>
      <p>Dates must be YYYY-MM-DD format. Times must be 24-hour HH:MM format.</p>
    </section>

    <footer>
      <p><a href="https://github.com/Unforced-Dev/natal-engine" target="_blank">natalengine</a> is open source. MIT License.</p>
    </footer>
  </div>
</body>
</html>