MCP-Server veröffentlichen

Erstellen Sie ein MCP-kompatibles Tool, stellen Sie es bereit und erreichen Sie Tausende von Entwicklern auf dem AppHighway-Marktplatz.

Warum auf AppHighway veröffentlichen?

AppHighway übernimmt Auffindbarkeit, Authentifizierung, Abrechnung und Ratenbegrenzung, damit Sie sich auf großartige Tools konzentrieren können.

Sofortige Auffindbarkeit

Ihr Tool erscheint im Marktplatz und in der MCP-Registry — KI-Agenten und Entwickler finden es automatisch.

Integrierte Abrechnung

Die punktebasierte Abrechnung wird für Sie übernommen. Keine Zahlungsintegration, Rechnungsstellung oder Abonnementverwaltung nötig.

Einheitliche Authentifizierung

Benutzer authentifizieren sich einmal mit ihrem AppHighway-Token. Sie erhalten validierte Anfragen — kein Auth-Code auf Ihrer Seite.

90/10-Umsatzbeteiligung

Sie behalten 90 % aller Punkte-Einnahmen, die Ihr Tool generiert. AppHighway behält 10 % für Plattformdienste.

Voraussetzungen

Was Sie benötigen, bevor Sie loslegen.

Node.js 18+ installiert
TypeScript-Kenntnisse (empfohlen, aber nicht erforderlich)
@modelcontextprotocol/sdk-Paket
Ein AppHighway-Publisher-Konto

MCP-Server erstellen

Folgen Sie diesen Schritten, um ein MCP-kompatibles Tool von Grund auf zu erstellen.

Schritt 1: Projekt initialisieren

Erstellen Sie ein neues Verzeichnis und initialisieren Sie ein TypeScript-Projekt.

bash
mkdir my-mcp-tool && cd my-mcp-tool
npm init -y
npm install typescript @types/node --save-dev
npx tsc --init
package.json
{
  "name": "my-mcp-tool",
  "version": "1.0.0",
  "type": "module",
  "main": "dist/index.js",
  "scripts": {
    "build": "tsc",
    "start": "node dist/index.js"
  },
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.0.0",
    "zod": "^3.22.0"
  },
  "devDependencies": {
    "@types/node": "^20.0.0",
    "typescript": "^5.3.0"
  }
}

Schritt 2: MCP SDK installieren

Installieren Sie das offizielle Model Context Protocol SDK und Zod für die Eingabevalidierung.

bash
npm install @modelcontextprotocol/sdk zod

Schritt 3: Tool definieren

Erstellen Sie Ihren MCP-Server mit Tool-Definitionen. Hier ist ein vollständiges Beispiel — ein Text-Analyzer-Tool, das Wortanzahl, Zeichenanzahl und Lesezeit zurückgibt.

src/index.ts
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import {
  CallToolRequestSchema,
  ListToolsRequestSchema,
} from "@modelcontextprotocol/sdk/types.js";

const server = new Server(
  { name: "text-analyzer", version: "1.0.0" },
  { capabilities: { tools: {} } }
);

// List available tools
server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [
    {
      name: "analyze_text",
      description: "Analyze text and return word count, character count, and estimated reading time.",
      inputSchema: {
        type: "object",
        properties: {
          text: {
            type: "string",
            description: "The text to analyze",
          },
        },
        required: ["text"],
      },
    },
  ],
}));

// Handle tool calls
server.setRequestHandler(CallToolRequestSchema, async (request) => {
  if (request.params.name === "analyze_text") {
    const { text } = request.params.arguments as { text: string };

    const words = text.split(/\s+/).filter(Boolean).length;
    const characters = text.length;
    const readingTimeMinutes = Math.ceil(words / 200);

    return {
      content: [
        {
          type: "text",
          text: JSON.stringify({
            words,
            characters,
            readingTimeMinutes,
          }, null, 2),
        },
      ],
    };
  }

  throw new Error(`Unknown tool: ${request.params.name}`);
});

// Start server with stdio transport
const transport = new StdioServerTransport();
await server.connect(transport);

Lokal testen

Testen Sie Ihren MCP-Server vor der Bereitstellung lokal mit dem MCP Inspector und Claude Desktop.

MCP Inspector

Der MCP Inspector ist ein browserbasiertes Tool zum interaktiven Testen von MCP-Servern.

bash
npx @modelcontextprotocol/inspector node dist/index.js

Mit Claude Desktop testen

Fügen Sie Ihren Server zur Konfiguration von Claude Desktop hinzu, um ihn mit einem echten KI-Agenten zu testen.

claude_desktop_config.json
{
  "mcpServers": {
    "text-analyzer": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"]
    }
  }
}

Server bereitstellen

Stellen Sie Ihren MCP-Server mit HTTP/SSE-Transport bereit, damit AppHighway Anfragen dorthin weiterleiten kann.

HTTP/SSE-Transport

Für die Marktplatz-Veröffentlichung benötigt Ihr Server einen HTTP-Endpunkt. Ersetzen Sie den stdio-Transport durch HTTP/SSE.

src/http-server.ts
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
import express from "express";

const app = express();
const server = new Server(
  { name: "text-analyzer", version: "1.0.0" },
  { capabilities: { tools: {} } }
);

// ... tool handlers (same as above) ...

app.get("/sse", async (req, res) => {
  const transport = new SSEServerTransport("/messages", res);
  await server.connect(transport);
});

app.post("/messages", async (req, res) => {
  // Handle incoming messages
});

app.listen(3001, () => {
  console.log("MCP server running on http://localhost:3001");
});

Hosting-Optionen

Bereitstellung bei jedem Hosting-Anbieter, der Node.js unterstützt:

VercelVercel — Serverless Functions, automatische Skalierung
RailwayRailway — Container-basiert, einfache Bereitstellung
Fly.ioFly.io — Edge Computing, globale Verteilung
VPSSelbst gehostet — Jeder VPS oder Cloud-Server mit Node.js

Bereitstellungsanforderungen

HTTPS-Endpunkt (für Produktion erforderlich)
99,5 %+ Verfügbarkeit empfohlen
Antwortzeit unter 30 Sekunden
CORS-Header für Cross-Origin-Anfragen

Auf AppHighway veröffentlichen

Sobald Ihr Server bereitgestellt und getestet ist, reichen Sie ihn über das Publisher-Dashboard ein.

Veröffentlichungsschritte

  1. Gehen Sie zu Ihrem Publisher-Dashboard
  2. Klicken Sie auf „Neues Tool“
  3. Füllen Sie die erforderlichen Felder aus
  4. Zur Überprüfung einreichen

Erforderliche Felder

Tool-Name — Ein klarer, beschreibender Name (z. B. „Text Analyzer“)
Slug — URL-freundlicher Bezeichner (z. B. „text-analyzer“)
Beschreibung — Was Ihr Tool macht und warum es nützlich ist (max. 500 Zeichen)
Kategorie — Auswahl aus: Datentransformation, KI & NLP, Entwickler-Tools, Medien & Dokumente, Web & Netzwerk
MCP-Server-URL — Ihr bereitgestellter HTTPS-Endpunkt
Punktekosten — Wie viele Punkte jeder Aufruf kostet (1–7 Punkte)

Überprüfungsprozess

Nach der Einreichung überprüft AppHighway Ihr Tool auf Qualität, Sicherheit und MCP-Kompatibilität. Überprüfungen werden in der Regel innerhalb von 2–3 Werktagen abgeschlossen.

Überprüfungskriterien

Tool funktioniert korrekt und liefert erwartete Ergebnisse
Keine Sicherheitslücken oder Datenlecks
Klare Beschreibung und Nutzungsanweisungen
Endpunkt antwortet innerhalb der Timeout-Grenzen
Folgt der MCP-Protokollspezifikation

Wie der Proxy funktioniert

Zu verstehen, wie AppHighway Anfragen an Ihren MCP-Server weiterleitet, hilft Ihnen, bessere Tools zu erstellen.

Anfrageablauf

1

Authentifizierung

Der Benutzer sendet eine Anfrage mit seinem Bearer-Token. AppHighway validiert den Token.

2

Ratenbegrenzung

Die Anfrage wird gegen das Ratenlimit des Benutzers geprüft (konfigurierbar pro Token).

3

Punkteabzug

Punkte werden vor der Weiterleitung der Anfrage vom Guthaben des Benutzers abgezogen (Vorab-Abzug).

4

Weiterleitung

Die validierte Anfrage wird mit einem internen Auth-Header an Ihren MCP-Server-Endpunkt weitergeleitet.

5

Antwort

Die Antwort Ihres Servers wird an den Benutzer zurückgegeben. Bei einem Serverfehler sieht der Benutzer einen standardisierten Fehler.

Einnahmen & Analysen

Verfolgen Sie die Leistung und Einnahmen Ihres Tools über das Publisher-Dashboard.

Einnahmemodell

Sie behalten 90 % aller Punkte-Einnahmen. AppHighway behält 10 % für Plattformdienste.

Einnahmeberechtigung

Nicht jede Nutzung generiert Publisher-Einnahmen:

Zahlende Abonnenten — Volle Umsatzbeteiligung (Sie verdienen 90 %)
Kostenlose Nutzer (150 Punkte/Monat) — Keine Publisher-Einnahmen
Empfehlungsnutzer (erster Monat) — Keine Publisher-Einnahmen

Publisher-Analysen

Ihr Dashboard zeigt:

Gesamtinstallationen und aktive Benutzer
Tägliche und monatliche Tool-Aufrufe
Einnahmenaufschlüsselung nach Zeitraum
Benutzerbewertungen und Rezensionen
Fehlerraten und Antwortzeiten
MCP-Server veröffentlichen — AppHighway