🚀 MCP-Server mit Autodesk Platform Services (APS)

📌 Übersicht

Dieses Projekt implementiert einen Model Context Protocol (MCP) Server mit Unterstützung für:

• Tool-Bereitstellung für LLM-Clients (z. B. VS Code Copilot)

• Externe API-Integration

• Autodesk Platform Services (APS) Konnektivität

• Authentifizierungsabläufe (2-legged & 3-legged OAuth)

• Benutzerdefinierte Client- + Agenten-Architektur

Es stellt ein produktionsorientiertes agentisches KI-Backend-System dar.

Related MCP server: RevitMCPBridge2026

🧠 Architektur

🔷 High-Level-Ablauf

+------------------------+
| LLM Client (VSCode)    |
| Copilot / Chat UI      |
+-----------+------------+
            |
            v
+------------------------+
| MCP Server             |
| (server.js / aps)      |
+-----------+------------+
            |
------------------------------------------------
      |                |                |
      v                v                v
+-------------+ +-------------+ +----------------+
| External    | |   APS APIs  | |  Custom Logic  |
| APIs        | | (OAuth)     | |   / Tools      |
+-------------+ +-------------+ +----------------+

🔷 Agenten-Ablauf

User Prompt
↓
LLM decides tool
↓
MCP Server executes tool
↓
External API / APS call
↓
Structured response → LLM → User

📁 Projektstruktur

├── .vscode/
│ └── mcp.json # MCP configuration for VS Code client
│
├── node_modules/ # Installed dependencies
│
├── .env # Environment variables (API keys, secrets)
├── .gitignore # Git ignored files
│
├── agent.js # Agent logic (tool orchestration)
├── aps-server.js # APS integration server (OAuth + APIs)
├── client.js # Custom MCP client implementation
├── server.js # Core MCP server (tool definitions)
│
├── package.json # Project metadata & dependencies
├── package-lock.json # Dependency lock file

⚙️ Tech-Stack

• Node.js (ES Modules)

• Model Context Protocol (MCP SDK)

• Zod (Schema-Validierung)

• HTTP Streaming Transport

• Autodesk Platform Services (APS)

🔑 Hauptkomponenten

1. server.js

• Kern-MCP-Server

• Registriert Tools

• Verarbeitet Client-Anfragen

2. aps-server.js

• Integriert Autodesk-APIs

• Verarbeitet OAuth (2L + 3L)

• Sichere API-Kommunikation

3. agent.js

• Implementiert agentisches Verhalten

• Entscheidet, welche Tools aufgerufen werden

• Ermöglicht mehrstufige Workflows

4. client.js

• Benutzerdefinierter MCP-Client

• Kann den VS Code-Client simulieren oder ersetzen

5. .vscode/mcp.json

• Verbindet VS Code → MCP-Server

🚀 Erste Schritte

1️⃣ Abhängigkeiten installieren

npm install

2️⃣ Umgebung einrichten

Erstellen Sie eine .env-Datei:

PORT=3000

# APS Credentials
APS_CLIENT_ID=your_client_id
APS_CLIENT_SECRET=your_client_secret

# External APIs
GEMINI_API_KEY=your_key

3️⃣ Server ausführen

node server.js

Erwartete Ausgabe:

MCP server running at http://localhost:3000/mcp

4️⃣ VS Code konfigurieren

Erstellen Sie:

.vscode/mcp.json

{
  "servers": {
    "devcon-workshop": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    },
    "devcon-aps": {
      "type": "http",
      "url": "http://localhost:3001/mcp"
    }
  }
}

5️⃣ Tools testen

Im Copilot Chat:

#add 10 and 20
#greet John in spanish
What's the weather in London?

🧩 Tool-Design-Muster

server.registerTool(
"tool_name",
{
description: "Tool description",
inputSchema: {
param: z.string()
}
},
async ({ param }) => ({
content: [{ type: "text", text: "Result" }]
})
);

🔐 Authentifizierung

✅ 2-Legged OAuth

Server-zu-Server

Keine Benutzerinteraktion

✅ 3-Legged OAuth

Benutzerzustimmung erforderlich

Feingranulare Berechtigungen

Empfohlen für die Produktion

🏗️ Überlegungen zur Produktion

🔹 Skalierbarkeit

Zustandslose Architektur

Horizontale Skalierung möglich

🔹 Sicherheit

Verwenden Sie .env für Geheimnisse

Bevorzugen Sie 3LO für Benutzerdaten

🔹 Zuverlässigkeit

Eingabevalidierung (Zod)

Strukturierte Antworten

🔹 Beobachtbarkeit Fügen Sie Protokollierung für die Tool-Ausführung hinzu

Überwachen Sie API-Fehler

🎯 Funktionen

✔ MCP-konformer Server

✔ Externe API-Integration

✔ APS-Konnektivität

✔ Agentenbasierte Ausführung

✔ Unterstützung für benutzerdefinierte Clients

🔮 Zukünftige Erweiterungen

Dockerisierung der Anwendung

Bereitstellung auf Azure / AWS

Datenbankgestützte Tools hinzufügen

Caching-Schicht implementieren

📜 Lizenz

MIT-Lizenz

🙌 Danksagungen

• Autodesk Platform Services (APS)
  https://autodesk-platform-services.github.io/mcp-devcon2026/

• Model Context Protocol (MCP)

• OpenAI / LLM-Ökosystem