classical-strategy-mcp 0.1.0__tar.gz

classical_strategy_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: classical-strategy-mcp
+Version: 0.1.0
+Summary: MCP server: 5,000 years of military strategy — Napoleon, Sun Tzu, Clausewitz, Alexander, Hannibal, Genghis Khan, Shaka Zulu, Caesar
+Project-URL: Homepage, https://github.com/gabrielmahia/classical-strategy-mcp
+License: MIT
+Keywords: clausewitz,history,mcp,military,napoleon,strategy,sun-tzu
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: fastmcp>=2.0.0
+Description-Content-Type: text/markdown
+
+# classical-strategy-mcp
+5,000 years of military strategy as AI tools.

classical_strategy_mcp-0.1.0/README.md

@@ -0,0 +1,2 @@
+# classical-strategy-mcp
+5,000 years of military strategy as AI tools.

classical_strategy_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "classical-strategy-mcp"
+version = "0.1.0"
+description = "MCP server: 5,000 years of military strategy — Napoleon, Sun Tzu, Clausewitz, Alexander, Hannibal, Genghis Khan, Shaka Zulu, Caesar"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+keywords = ["mcp","strategy","military","napoleon","sun-tzu","clausewitz","history"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+]
+dependencies = ["fastmcp>=2.0.0"]
+
+[project.urls]
+Homepage = "https://github.com/gabrielmahia/classical-strategy-mcp"
+
+[project.scripts]
+classical-strategy-mcp = "classical_strategy_mcp.main:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/classical_strategy_mcp"]

classical_strategy_mcp-0.1.0/src/classical_strategy_mcp/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

classical_strategy_mcp-0.1.0/src/classical_strategy_mcp/main.py

@@ -0,0 +1,104 @@
+"""classical-strategy-mcp — 5,000 years of military strategy."""
+from __future__ import annotations
+import json, pathlib
+from typing import Annotated
+from fastmcp import FastMCP
+
+mcp = FastMCP(
+    name="classical-strategy-mcp",
+    instructions=(
+        "Access 5,000 years of military strategy and philosophy as AI tools. "
+        "Napoleon maxims, Sun Tzu, Clausewitz, Alexander, Hannibal, Genghis Khan, "
+        "Shaka Zulu, Caesar — all public domain, structured for AI analysis."
+    ),
+)
+
+COMMANDERS = {
+    "napoleon": {"dates":"1769-1821","nationality":"French","key_doctrine":"Corps system + central position + decisive battle","source":"Maximes de Guerre, 1831 (PD)"},
+    "sun_tzu":  {"dates":"~500 BC","nationality":"Chinese","key_doctrine":"Win without fighting — supreme excellence","source":"Art of War (PD)"},
+    "clausewitz":{"dates":"1780-1831","nationality":"Prussian","key_doctrine":"Fog, friction, center of gravity, culminating point","source":"On War, 1832 (PD)"},
+    "alexander":{"dates":"356-323 BC","nationality":"Macedonian","key_doctrine":"Hammer (cavalry) + anvil (phalanx) + oblique approach","source":"Arrian (PD)"},
+    "hannibal": {"dates":"247-183 BC","nationality":"Carthaginian","key_doctrine":"Cannae double envelopment — feign weakness, encircle","source":"Polybius (PD)"},
+    "genghis":  {"dates":"1162-1227","nationality":"Mongol","key_doctrine":"Intelligence + speed + feigned retreat + total warfare","source":"Secret History of the Mongols (PD)"},
+    "shaka":    {"dates":"1787-1828","nationality":"Zulu","key_doctrine":"Iklwa close combat + bull-horn encirclement + amabutho system","source":"Isaacs, Fynn (PD)"},
+    "caesar":   {"dates":"100-44 BC","nationality":"Roman","key_doctrine":"Speed + engineering + fortification + clemency","source":"De Bello Gallico (PD)"},
+    "machiavelli":{"dates":"1469-1527","nationality":"Florentine","key_doctrine":"Power realism — means justify ends in statecraft","source":"The Prince, 1532; Art of War, 1521 (PD)"},
+    "frederick":{"dates":"1712-1786","nationality":"Prussian","key_doctrine":"Oblique order + interior lines","source":"Instructions for His Generals, 1747 (PD)"},
+}
+
+MAXIMS = [
+    {"number":1,"text":"An army marches on its stomach.","category":"logistics","commander":"Napoleon"},
+    {"number":2,"text":"Never interrupt your enemy when he is making a mistake.","category":"strategy","commander":"Napoleon"},
+    {"number":3,"text":"The strength of an army is estimated by multiplying mass by rapidity.","category":"tactics","commander":"Napoleon"},
+    {"number":4,"text":"In war, three-quarters turns on personal character. Materials count for only a quarter.","category":"leadership","commander":"Napoleon"},
+    {"number":5,"text":"Supreme excellence consists in breaking the enemy's resistance without fighting.","category":"strategy","commander":"Sun Tzu"},
+    {"number":6,"text":"All warfare is based on deception.","category":"strategy","commander":"Sun Tzu"},
+    {"number":7,"text":"If you know the enemy and know yourself, you need not fear the result of a hundred battles.","category":"intelligence","commander":"Sun Tzu"},
+    {"number":8,"text":"War is the continuation of policy by other means.","category":"strategy","commander":"Clausewitz"},
+    {"number":9,"text":"In war, everything is simple, but the simplest thing is difficult.","category":"strategy","commander":"Clausewitz"},
+    {"number":10,"text":"Speed is the essence of war. Take advantage of the enemy's unpreparedness.","category":"tactics","commander":"Sun Tzu"},
+    {"number":11,"text":"It is better to be feared than loved, if you cannot be both.","category":"leadership","commander":"Machiavelli"},
+    {"number":12,"text":"Never fight against concentrated enemy forces when you are dispersed.","category":"tactics","commander":"Napoleon"},
+    {"number":13,"text":"Let your plans be dark and impenetrable as night, and when you move, fall like a thunderbolt.","category":"tactics","commander":"Sun Tzu"},
+    {"number":14,"text":"Wars are begun when one wills, but not ended when one wills.","category":"strategy","commander":"Machiavelli"},
+    {"number":15,"text":"The greatest general is he who makes the fewest mistakes.","category":"leadership","commander":"Napoleon"},
+]
+
+@mcp.tool(description="Get military maxims from history's greatest commanders. Filter by category or commander.")
+def get_maxims(category: Annotated[str,"Filter: strategy|tactics|logistics|leadership|intelligence|all"]="all",
+               commander: Annotated[str,"Filter by commander name or 'all'"]="all") -> dict:
+    results = MAXIMS
+    if category != "all": results = [m for m in results if m.get("category")==category]
+    if commander != "all": results = [m for m in results if commander.lower() in m.get("commander","").lower()]
+    return {"count":len(results),"maxims":results,"note":"All sources public domain"}
+
+@mcp.tool(description="Get detailed doctrine analysis for a specific commander.")
+def commander_doctrine(commander: Annotated[str,"Commander: napoleon|sun_tzu|clausewitz|alexander|hannibal|genghis|shaka|caesar|machiavelli|frederick"]="napoleon") -> dict:
+    d = COMMANDERS.get(commander.lower())
+    if not d: return {"error":f"Not found. Available: {list(COMMANDERS.keys())}"}
+    return {"commander":commander.title(), **d}
+
+@mcp.tool(description="Apply classical strategy principles to a modern problem.")
+def apply_classical_strategy(problem: Annotated[str,"Describe your strategic challenge"],
+                              lens: Annotated[str,"Focus: competition|leadership|intelligence|resources|operations"]="competition") -> dict:
+    frameworks = {
+        "competition": ["Sun Tzu: Win without fighting — superior position before battle","Napoleon: Concentrate force at the decisive point","Hannibal: Appear weak where you plan to be strong (Cannae)","Clausewitz: Identify the enemy's center of gravity","Caesar: Speed as strategic weapon — arrive before expected"],
+        "leadership":  ["Napoleon: Three-quarters of war is character, only a quarter is material","Alexander: Lead from the front — personal risk creates disproportionate loyalty","Shaka: Reward performance, not seniority — amabutho system","Clausewitz: Friction is constant — plan for it, don't be surprised","Frederick: Train harder than you fight"],
+        "intelligence":["Sun Tzu: Foreknowledge from men, not spirits — human intelligence first","Genghis Khan: Know enemy terrain, politics, morale before engaging","Napoleon: Never rely on a single source — cross-verify everything","Caesar: Personally observe — don't rely solely on reports"],
+        "resources":   ["Napoleon: Concentrate before committing — dispersion before decision is fatal","Clausewitz: Know your culminating point — stop before you overextend","Genghis Khan: Self-sustaining force — minimize supply line dependence","Frederick: Concentration at decisive point beats numerical superiority"],
+        "operations":  ["Caesar: Speed + fortification — move fast, consolidate immediately","Napoleon: Corps system — autonomous units, centralized intent","Genghis Khan: 60-80 miles/day — speed multiplies all other advantages","Shaka: Total system transformation, not incremental improvement"],
+    }
+    return {"problem":problem,"lens":lens,"frameworks":frameworks.get(lens,frameworks["competition"]),"source":"Synthesized from public domain military literature"}
+
+@mcp.tool(description="Get a bibliography of major public domain strategic works with descriptions.")
+def strategic_library(domain: Annotated[str,"Domain: military|philosophy|history|all"]="all") -> dict:
+    lib = {
+        "military":[
+            {"title":"The Art of War","author":"Sun Tzu","date":"~500 BC","format":"Book, AI dataset, structured JSON"},
+            {"title":"On War (Vom Kriege)","author":"Clausewitz","date":"1832","format":"Book, workbook editions"},
+            {"title":"The Gallic Wars","author":"Julius Caesar","date":"58 BC","format":"Primary source narrative"},
+            {"title":"Napoleon's Maxims","author":"Napoleon Bonaparte","date":"1831","format":"Aphorism collection, card deck potential"},
+            {"title":"Instructions for His Generals","author":"Frederick the Great","date":"1747","format":"Leadership manual"},
+            {"title":"Epitome Rei Militaris","author":"Vegetius","date":"~390 AD","format":"Military manual"},
+        ],
+        "philosophy":[
+            {"title":"Meditations","author":"Marcus Aurelius","date":"~180 AD","format":"Journal, daily reading"},
+            {"title":"The Prince","author":"Machiavelli","date":"1532","format":"Political treatise"},
+            {"title":"Letters from a Stoic","author":"Seneca","date":"~65 AD","format":"Letters, wisdom collection"},
+            {"title":"Enchiridion","author":"Epictetus","date":"~135 AD","format":"Stoic handbook"},
+        ],
+        "history":[
+            {"title":"Histories","author":"Polybius","date":"~150 BC","format":"Primary source — Hannibal"},
+            {"title":"Parallel Lives","author":"Plutarch","date":"~100 AD","format":"Biographical — Alexander, Caesar"},
+            {"title":"Travels in Eastern Africa","author":"Nathaniel Isaacs","date":"1836","format":"Primary source — Shaka Zulu"},
+            {"title":"Secret History of the Mongols","author":"Anonymous","date":"~1240","format":"Primary source — Genghis Khan"},
+        ],
+    }
+    if domain == "all": return {"library":lib,"total":sum(len(v) for v in lib.values())}
+    return {"domain":domain,"works":lib.get(domain,[])}
+
+def main():
+    mcp.run()
+
+if __name__ == "__main__":
+    main()