Skip to content

Commit 1e29a67

Browse files
sylvain-guilletsylvain-guillet
committed
Enhance howto-mini.html by updating section headers and improving styling for better readability
1 parent b3cb035 commit 1e29a67

File tree

1 file changed

+119
-79
lines changed

1 file changed

+119
-79
lines changed

‎docs/howto-mini.html‎

Lines changed: 119 additions & 79 deletions
Original file line numberDiff line numberDiff line change
@@ -1,64 +1,106 @@
11
<!doctype html>
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-
h1, h2 { margin: 0 0 12px; line-height: 1.2; }
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; }
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+
1645
/* Brand colors */
17-
p { color: #8A8A8A; }
18-
a { color: #B38B4F; text-decoration: none; }
19-
a:hover { text-decoration: underline; }
20-
h2 { color: #B38B4F; }
21-
</style>
22-
</head>
23-
<body>
24-
<main>
25-
<!-- Removed main title per integration into existing page -->
26-
<p>Use the hosted server now, or self-host fast with Docker or .NET. Minimal steps below.</p>
27-
28-
<section>
29-
<h2>1) Hosted (no setup)</h2>
30-
<ul>
31-
<li>Base URL: <a href="https://mcp.io-aerospace.org" target="_blank" rel="noreferrer noopener">https://mcp.io-aerospace.org</a></li>
32-
<li>SSE (manual/web): <a href="https://mcp.io-aerospace.org/sse" target="_blank" rel="noreferrer noopener">/sse</a></li>
33-
<li>Most MCP clients only need the base URL.</li>
34-
</ul>
35-
</section>
36-
37-
<section>
38-
<h2>2) MCP client (Claude Desktop, HTTP)</h2>
39-
<pre><code class="language-json">{
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>1 | 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>2 | MCP client (Claude Desktop, HTTP)</h3>
81+
<pre><code class="language-json">{
4082
"mcpServers": {
4183
"astrodynamics": {
4284
"transport": { "type": "http", "url": "https://mcp.io-aerospace.org" }
4385
}
4486
}
4587
}
4688
</code></pre>
47-
</section>
89+
</section>
4890

49-
<section>
50-
<h2>3) Self-host quick</h2>
51-
<p><strong>Docker (dev):</strong></p>
52-
<pre><code class="language-bash">git clone https://github.com/IO-Aerospace-software-engineering/mcp-server
91+
<section>
92+
<h3>3 | 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
5395
cd mcp-server
5496
docker-compose up
5597
</code></pre>
56-
<ul>
57-
<li>HTTP: http://localhost:8080</li>
58-
</ul>
98+
<ul>
99+
<li>HTTP: http://localhost:8080</li>
100+
</ul>
59101

60-
<p><strong>.NET:</strong></p>
61-
<pre><code class="language-bash">git clone https://github.com/IO-Aerospace-software-engineering/mcp-server
102+
<p><strong>.NET:</strong></p>
103+
<pre><code class="language-bash">git clone https://github.com/IO-Aerospace-software-engineering/mcp-server
62104
cd mcp-server
63105
dotnet build
64106
# STDIO (MCP clients)
@@ -68,35 +110,33 @@ <h2>3) Self-host quick</h2>
68110
# HTTP/SSE (web)
69111
cd Server.Sse && dotnet run # http://localhost:8080
70112
</code></pre>
71-
</section>
72-
73-
<section>
74-
<h2>4) Kernels (minimal set)</h2>
75-
<ul>
76-
<li>de440s.bsp (ephemeris)</li>
77-
<li>latest_leapseconds.tls</li>
78-
<li>pck00011.tpc</li>
79-
<li>earth_latest_high_prec.bpc</li>
80-
</ul>
81-
</section>
82-
83-
<section>
84-
<h2>5) Troubleshooting</h2>
85-
<ul>
86-
<li>Missing kernels dir: fix <code>-k</code> or <code>IO_DATA_DIR</code> path.</li>
87-
<li>Kernel load failed: ensure files exist and are readable.</li>
88-
<li>HTTP errors: check ports/firewall/proxy.</li>
89-
</ul>
90-
</section>
91-
92-
<section>
93-
<h2>Links</h2>
94-
<ul>
95-
<li>Hosted: <a href="https://mcp.io-aerospace.org" target="_blank" rel="noreferrer noopener">mcp.io-aerospace.org</a></li>
96-
<li>Repo: <a href="https://github.com/IO-Aerospace-software-engineering/mcp-server" target="_blank" rel="noreferrer noopener">GitHub</a></li>
97-
<li>Astrodynamics framework: <a href="https://github.com/IO-Aerospace-software-engineering/Astrodynamics" target="_blank" rel="noreferrer noopener">GitHub</a></li>
98-
</ul>
99-
</section>
100-
</main>
101-
</body>
102-
</html>
113+
</section>
114+
115+
<section>
116+
<h3>4 | 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>5 | 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>

0 commit comments

Comments
 (0)