Skip to content

Commit 1d6b7f0

Browse files
committed
diagram update
1 parent 895d91d commit 1d6b7f0

File tree

2 files changed

+92
-0
lines changed

2 files changed

+92
-0
lines changed
-21.5 KB
Loading

why-mcp.html

Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
<!DOCTYPE html>
2+
<html lang="en">
3+
<head>
4+
<meta charset="UTF-8">
5+
<title>Why MCP – Smarter Execution, Not Harder Integration</title>
6+
<style>
7+
body {
8+
font-family: Arial, sans-serif;
9+
max-width: 800px;
10+
margin: 2rem auto;
11+
line-height: 1.6;
12+
padding: 1rem;
13+
}
14+
h1, h2 {
15+
color: #2c3e50;
16+
}
17+
.highlight {
18+
background: #e0f7fa;
19+
padding: 0.5rem;
20+
border-left: 4px solid #00acc1;
21+
}
22+
table {
23+
width: 100%;
24+
border-collapse: collapse;
25+
margin-top: 1rem;
26+
}
27+
table, th, td {
28+
border: 1px solid #ccc;
29+
}
30+
th, td {
31+
padding: 0.5rem;
32+
text-align: left;
33+
}
34+
</style>
35+
</head>
36+
<body>
37+
<h1>Why MCP – Smarter Execution, Not Harder Integration</h1>
38+
39+
<h2>Plan in Natural Language. Execute in Structured Logic.</h2>
40+
<p class="highlight">
41+
MCP lets LLMs create safe, rule-enforced multi-step API calls — without rewriting your backend.
42+
</p>
43+
44+
<h2>The Problem</h2>
45+
<p>
46+
Traditional integration requires hard-coded endpoints, hand-authored logic, and brittle glue code between systems.
47+
</p>
48+
<ul>
49+
<li>❌ Dev time wasted</li>
50+
<li>❌ Hard to extend</li>
51+
<li>❌ No AI-readability</li>
52+
</ul>
53+
54+
<h2>The MCP Difference</h2>
55+
<p>
56+
MCP introduces a simple pattern: <strong>LLMs plan. APIs execute. Business logic is enforced.</strong>
57+
</p>
58+
<ul>
59+
<li>🔹 Natural language in → structured API plan out</li>
60+
<li>🔹 Tool context drives calls across services</li>
61+
<li>🔹 JSON:API enforces business rules — not just CRUD</li>
62+
</ul>
63+
64+
<h2>How It Works</h2>
65+
<p>
66+
MCP is not a new API. It’s a convention — lightweight, flexible, and LLM-native.
67+
</p>
68+
<ul>
69+
<li><strong>MCP Client</strong>: Accepts user goals, sends schema + goal to an LLM, executes returned tool contexts</li>
70+
<li><strong>MCP Server</strong>: Just your existing JSON:API server, enforces business rules declaratively, returns real results</li>
71+
</ul>
72+
<p>✅ You already have the server.<br>
73+
✅ Just add a client and a schema.</p>
74+
75+
<h2>Why It’s Better</h2>
76+
<table>
77+
<thead>
78+
<tr><th>Feature</th><th>Without MCP</th><th>With MCP</th></tr>
79+
</thead>
80+
<tbody>
81+
<tr><td>Add logic</td><td>Hand-code endpoints</td><td>Describe with rules</td></tr>
82+
<tr><td>Use with AI</td><td>Ad-hoc calls</td><td>LLM-native orchestration</td></tr>
83+
<tr><td>Scaling</td><td>Spaghetti glue code</td><td>Composable tool contexts</td></tr>
84+
<tr><td>Explainability</td><td>Opaque logic</td><td>Declarative, traceable</td></tr>
85+
</tbody>
86+
</table>
87+
88+
<h2>Get Started</h2>
89+
<p><strong>Start fast. Stay clean. Think in terms of tools, not tunnels.</strong><br>
90+
Use MCP to turn your services into orchestration-ready systems, today.</p>
91+
</body>
92+
</html>

0 commit comments

Comments
 (0)