Skip to content

Commit f5bd4fd

Browse files
sylvain-guilletsylvain-guillet
committed
Refactor howto-mini.html for improved structure and styling
1 parent 5f5660c commit f5bd4fd

File tree

1 file changed

+111
-121
lines changed

1 file changed

+111
-121
lines changed

‎docs/howto-mini.html‎

Lines changed: 111 additions & 121 deletions
Original file line numberDiff line numberDiff line change
@@ -1,106 +1,94 @@
11
<!doctype html>
2-
3-
<style>
4-
:root {
5-
color-scheme: light dark;
6-
}
7-
8-
body {
9-
font-family: system-ui, -apple-system, Segoe UI, Roboto, Ubuntu, Cantarell, Arial, sans-serif;
10-
line-height: 1.5;
11-
margin: 0;
12-
}
13-
14-
main {
15-
max-width: 860px;
16-
margin: 0 auto;
17-
padding: 28px 16px 56px;
18-
}
19-
20-
h1, h2 {
21-
margin: 0 0 12px;
22-
line-height: 1.2;
23-
}
24-
25-
section {
26-
margin: 20px 0 24px;
27-
}
28-
29-
pre {
30-
background: rgba(127, 127, 127, .12);
31-
padding: 10px 12px;
32-
border-radius: 8px;
33-
overflow: auto;
34-
}
35-
36-
code {
37-
font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace;
38-
font-size: 0.95em;
39-
}
40-
41-
ul {
42-
margin: 8px 0 0 18px;
43-
}
44-
45-
/* Brand colors */
46-
p {
47-
color: #8A8A8A;
48-
}
49-
50-
a {
51-
color: #B38B4F;
52-
text-decoration: none;
53-
}
54-
55-
a:hover {
56-
text-decoration: underline;
57-
}
58-
59-
h2 {
60-
color: white;
61-
}
62-
h3 {
63-
color: white;
64-
}
65-
</style>
66-
<div>
67-
<!-- Removed main title per integration into existing page -->
68-
<p>Use the hosted server now, or self-host fast with Docker or .NET. Minimal steps below.</p>
69-
70-
<section>
71-
<h3>Hosted (no setup)</h3>
72-
<ul>
73-
<li>Base URL: <a href="https://mcp.io-aerospace.org" target="_blank" rel="noreferrer noopener">https://mcp.io-aerospace.org</a></li>
74-
<li>SSE (manual/web): <a href="https://mcp.io-aerospace.org/sse" target="_blank" rel="noreferrer noopener">/sse</a></li>
75-
<li>Most MCP clients only need the base URL.</li>
76-
</ul>
77-
</section>
78-
79-
<section>
80-
<h3>MCP client (Claude Desktop, HTTP)</h3>
81-
<pre><code class="language-json">{
2+
<html lang="en">
3+
<head>
4+
<meta charset="utf-8" />
5+
<meta name="viewport" content="width=device-width,initial-scale=1" />
6+
<title>IO Aerospace MCP Server – Quick How To</title>
7+
<style>
8+
:root { color-scheme: light dark; }
9+
body { font-family: system-ui, -apple-system, Segoe UI, Roboto, Ubuntu, Cantarell, Arial, sans-serif; line-height: 1.5; margin: 0; }
10+
main { max-width: 860px; margin: 0 auto; padding: 28px 16px 56px; }
11+
h2, h3 { margin: 0 0 12px; line-height: 1.2; color: #B38B4F; }
12+
section { margin: 20px 0 24px; }
13+
pre { background: rgba(127,127,127,.12); padding: 10px 12px; border-radius: 8px; overflow: auto; }
14+
code { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-size: 0.95em; }
15+
ul { margin: 8px 0 0 18px; }
16+
p { color: #8A8A8A; }
17+
a { color: #B38B4F; text-decoration: none; }
18+
a:hover { text-decoration: underline; }
19+
</style>
20+
</head>
21+
<body>
22+
<main>
23+
<!-- No main title (embedded into existing page) -->
24+
<p>Use the hosted server now, or self-host fast with Docker or .NET. Minimal steps below.</p>
25+
26+
<section>
27+
<h3>Hosted (no setup)</h3>
28+
<ul>
29+
<li>Base URL: <a href="https://mcp.io-aerospace.org" target="_blank" rel="noreferrer noopener">https://mcp.io-aerospace.org</a></li>
30+
<li>SSE (manual/web): <a href="https://mcp.io-aerospace.org/sse" target="_blank" rel="noreferrer noopener">/sse</a></li>
31+
<li>Most MCP clients only need the base URL.</li>
32+
</ul>
33+
</section>
34+
35+
<section>
36+
<h3>MCP client (Claude Desktop, HTTP)</h3>
37+
<pre><code class="language-json">{
8238
"mcpServers": {
8339
"astrodynamics": {
8440
"transport": { "type": "http", "url": "https://mcp.io-aerospace.org" }
8541
}
8642
}
8743
}
8844
</code></pre>
89-
</section>
90-
91-
<section>
92-
<h3>Self-host quick</h3>
93-
<p><strong>Docker (dev):</strong></p>
94-
<pre><code class="language-bash">git clone https://github.com/IO-Aerospace-software-engineering/mcp-server
45+
</section>
46+
47+
<section>
48+
<h3>MCP client (STDIO)</h3>
49+
<ul>
50+
<li>Download the Server.Stdio executable for your OS (see “Download executables”).</li>
51+
<li>Provide kernels via <code>-k</code> or <code>IO_DATA_DIR</code>.</li>
52+
</ul>
53+
<pre><code class="language-json">{
54+
"mcpServers": {
55+
"astrodynamics": {
56+
"command": "/path/to/Server.Stdio",
57+
"args": ["-k", "/path/to/kernels"]
58+
}
59+
}
60+
}
61+
</code></pre>
62+
<pre><code class="language-bash"># Run directly
63+
./Server.Stdio -k /path/to/kernels
64+
# Windows
65+
Server.Stdio.exe -k C:\path\to\kernels
66+
</code></pre>
67+
</section>
68+
69+
<section>
70+
<h3>Download executables</h3>
71+
<ul>
72+
<li>Releases: <a href="https://github.com/IO-Aerospace-software-engineering/mcp-server/releases" target="_blank" rel="noreferrer noopener">GitHub Releases</a> → download single-file Server.Stdio for your OS (linux-x64, win-x64, osx-arm64).</li>
73+
<li>Actions (artifacts): <a href="https://github.com/IO-Aerospace-software-engineering/mcp-server/actions/workflows/release.yml" target="_blank" rel="noreferrer noopener">Release single-file (server.Stdio)</a> → latest run → Artifacts → pick your OS.</li>
74+
<li>Linux/macOS: <code>chmod +x ./Server.Stdio</code></li>
75+
<li>macOS (if blocked): <code>xattr -d com.apple.quarantine ./Server.Stdio</code></li>
76+
</ul>
77+
</section>
78+
79+
<section>
80+
<h3>Self-host quick</h3>
81+
<p><strong>Docker (dev):</strong></p>
82+
<pre><code class="language-bash">git clone https://github.com/IO-Aerospace-software-engineering/mcp-server
9583
cd mcp-server
9684
docker-compose up
9785
</code></pre>
98-
<ul>
99-
<li>HTTP: http://localhost:8080</li>
100-
</ul>
86+
<ul>
87+
<li>HTTP: http://localhost:8080</li>
88+
</ul>
10189

102-
<p><strong>.NET:</strong></p>
103-
<pre><code class="language-bash">git clone https://github.com/IO-Aerospace-software-engineering/mcp-server
90+
<p><strong>.NET:</strong></p>
91+
<pre><code class="language-bash">git clone https://github.com/IO-Aerospace-software-engineering/mcp-server
10492
cd mcp-server
10593
dotnet build
10694
# STDIO (MCP clients)
@@ -110,33 +98,35 @@ <h3>Self-host quick</h3>
11098
# HTTP/SSE (web)
11199
cd Server.Sse && dotnet run # http://localhost:8080
112100
</code></pre>
113-
</section>
114-
115-
<section>
116-
<h3>Kernels (minimal set)</h3>
117-
<ul>
118-
<li>de440s.bsp (ephemeris)</li>
119-
<li>latest_leapseconds.tls</li>
120-
<li>pck00011.tpc</li>
121-
<li>earth_latest_high_prec.bpc</li>
122-
</ul>
123-
</section>
124-
125-
<section>
126-
<h3>Troubleshooting</h3>
127-
<ul>
128-
<li>Missing kernels dir: fix <code>-k</code> or <code>IO_DATA_DIR</code> path.</li>
129-
<li>Kernel load failed: ensure files exist and are readable.</li>
130-
<li>HTTP errors: check ports/firewall/proxy.</li>
131-
</ul>
132-
</section>
133-
134-
<section>
135-
<h3>Links</h3>
136-
<ul>
137-
<li>Hosted: <a href="https://mcp.io-aerospace.org" target="_blank" rel="noreferrer noopener">mcp.io-aerospace.org</a></li>
138-
<li>Repo: <a href="https://github.com/IO-Aerospace-software-engineering/mcp-server" target="_blank" rel="noreferrer noopener">GitHub</a></li>
139-
<li>Astrodynamics framework: <a href="https://github.com/IO-Aerospace-software-engineering/Astrodynamics" target="_blank" rel="noreferrer noopener">GitHub</a></li>
140-
</ul>
141-
</section>
142-
</div>
101+
</section>
102+
103+
<section>
104+
<h3>Kernels (minimal set)</h3>
105+
<ul>
106+
<li>de440s.bsp (ephemeris)</li>
107+
<li>latest_leapseconds.tls</li>
108+
<li>pck00011.tpc</li>
109+
<li>earth_latest_high_prec.bpc</li>
110+
</ul>
111+
</section>
112+
113+
<section>
114+
<h3>Troubleshooting</h3>
115+
<ul>
116+
<li>Missing kernels dir: fix <code>-k</code> or <code>IO_DATA_DIR</code> path.</li>
117+
<li>Kernel load failed: ensure files exist and are readable.</li>
118+
<li>HTTP errors: check ports/firewall/proxy.</li>
119+
</ul>
120+
</section>
121+
122+
<section>
123+
<h3>Links</h3>
124+
<ul>
125+
<li>Hosted: <a href="https://mcp.io-aerospace.org" target="_blank" rel="noreferrer noopener">mcp.io-aerospace.org</a></li>
126+
<li>Repo: <a href="https://github.com/IO-Aerospace-software-engineering/mcp-server" target="_blank" rel="noreferrer noopener">GitHub</a></li>
127+
<li>Astrodynamics framework: <a href="https://github.com/IO-Aerospace-software-engineering/Astrodynamics" target="_blank" rel="noreferrer noopener">GitHub</a></li>
128+
</ul>
129+
</section>
130+
</main>
131+
</body>
132+
</html>

0 commit comments

Comments
 (0)