Serve7 MCP Connector Library

Wiederverwendbare MCP-Tools für Amazon Connect AI Agents und Bedrock AgentCore. Sieben generische Connectors – Kundensuche, Support-Ticket erstellen, Ticketstatus prüfen, Termin vereinbaren, CRM-Datensatz aktualisieren, Wissen abrufen und Aufgabe erstellen – werden hier einmal gebaut und dann bei jedem Serve7-Kundenprojekt wiederverwendet, statt für jedes Projekt von Grund auf neu verdrahtet zu werden.

Das ist Projekt #6 aus der Praktikumsideenliste für den Herbst 2026 („Serve7 MCP Connector Library“). Es ist eine funktionierende erste Version: Jeder Connector läuft heute Ende-zu-Ende gegen ein In-Memory-Mock-Backend (kein AWS-Konto, kein Live-CRM, keine Anmeldedaten erforderlich, um es auszuprobieren), mit einer sauberen Nahtstelle für den späteren Austausch gegen ein echtes Backend.

Warum ein Adapter und nicht eine direkte Integration

Die Geschäftslogik jedes Connectors (Schema-Validierung, was als Fehler gilt, welche Felder ein- und ausgehen) liegt in src/connectors/*.ts und spricht nie direkt mit einem konkreten Backend-SDK. Stattdessen ruft sie eine der fünf kleinen Schnittstellen in src/adapters/types.ts auf – CrmAdapter, TicketingAdapter, SchedulingAdapter, KnowledgeAdapter, TaskAdapter. Heute sind diese alle in-memory implementiert (src/adapters/mock.ts). Morgen, wenn ein echtes Salesforce/ServiceNow/Connect-Cases/Bedrock-Knowledge-Base-Backend angebunden wird, bedeutet das, eine neue Adapterklasse zu schreiben und eine switch-Anweisung umzustellen (src/adapters/index.ts) – keine Änderungen am Connector-Code, an seinen Tests oder an den MCP-Tooldefinitionen, die ein Agent sieht. Siehe docs/adding-a-real-adapter.md.

MCP client (Claude Desktop, Bedrock AgentCore, ...)
        │  tool call: customer_lookup({ customerId: "cust-1001" })
        ▼
src/server.ts (stdio) or src/http-server.ts (deployed)
        │  registers every connector as an MCP tool
        ▼
src/connectors/customer-lookup.ts
        │  validates input (zod), calls adapters.crm.lookupCustomer(...)
        ▼
src/adapters/index.ts  →  mock.ts today, a real adapter later

Related MCP server: Runtime MCP Server

Projektaufbau

src/
  connectors/       one file per MCP tool — schema + business logic only
  adapters/          the CRM/ticketing/scheduling/knowledge/task interfaces,
                      plus the in-memory mock implementations
  mock-data/         seed data the mock adapters serve
  mcp-server-factory.ts   registers every connector on an McpServer instance
  server.ts          stdio entrypoint (local dev, Claude Desktop, Claude Code)
  http-server.ts      Streamable-HTTP entrypoint (deployed, e.g. behind Lambda)
tests/               one test file per connector + a registry sanity test
deploy/              Dockerfile + AWS SAM template for a Lambda deployment
docs/                per-connector reference + how to add a real adapter

Lokales Ausführen

npm install
npm test              # 29 tests, all against the mock adapters
npm run typecheck      # strict TypeScript, zero `any` in connector code
npm start              # stdio MCP server — Ctrl+C to stop
npm run start:http      # HTTP MCP server on :8080 (curl http://localhost:8080/health)
npm run smoke           # real MCP client over stdio, calls all 7 tools end to end
npm run smoke:http      # same, over HTTP — start:http must be running first

Einbinden in Claude Desktop / Claude Code

Richten Sie einen MCP-Client auf den Stdio-Server aus, z. B. in der claude_desktop_config.json von Claude Desktop:

{
  "mcpServers": {
    "serve7-connectors": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/serve7-mcp-connectors/src/server.ts"]
    }
  }
}

Dann fragen Sie ihn z. B. „Schlage den Kunden cust-1001 nach“ oder „Was haben wir für Wissensartikel zu Ankündigungen von Notfallschließungen?“ – er ruft dabei customer_lookup bzw. retrieve_knowledge gegen die Mock-Daten auf.

Für den Echtbetrieb bereitstellen (z. B. von Bedrock AgentCore aus)

Siehe deploy/README.md – baut eine Lambda als Container-Image mit einer IAM-geschützten Function-URL über sam deploy.

Einen 8. Connector hinzufügen

1. Erstellen Sie src/connectors/my-new-tool.ts mit defineConnector() – übernehmen Sie die Struktur eines vorhandenen Connectors, z. B. create-task.ts.

2. Fügen Sie ihn zum CONNECTORS-Array in src/connectors/index.ts hinzu.

3. Fügen Sie eine Testdatei in tests/ hinzu.

4. Dokumentieren Sie ihn in docs/connectors.md.

server.ts, http-server.ts und der Registry-Test nehmen ihn automatisch auf – sonst muss nichts weiter angefasst werden.

Was bewusst in dieser ersten Version nicht im Umfang liegt

Gemäß der ursprünglichen Projektbeschreibung sollte jeder Connector später auch einen Authentifizierungsansatz (umgesetzt, auf Adapter-Ebene), eine Deployment-Vorlage (umgesetzt, deploy/) und eine Dokumentation (umgesetzt, docs/) abdecken – alles ist ausgeliefert. Noch nicht gebaut und eine zügige Folgearbeit wert: ein echter Adapter für mindestens ein Backend (damit das Ganze nicht mehr nur aus Mocks besteht) sowie das Anbinden eines echten Agenten von Bedrock AgentCore, der den Connector über den bereitgestellten HTTP-Endpunkt Ende-zu-Ende aufruft.