MCP Server Starter

Eine produktionsbereite Startervorlage zum Erstellen von Model Context Protocol (MCP)-Servern mit TypeScript.

🚀 Schnellstart

Klonen Sie das Repository
Installieren Sie Abhängigkeiten:
bun install

✨ Hauptmerkmale

Bun für schnelles Testen und Entwickeln
Biom zum Lintisieren und Formatieren
Automatisiertes Versionsmanagement mit Standard-Version
Saubere, wartbare Projektstruktur

📂 Projektstruktur

mcp-starter/
├── src/
│   ├── tools/          # MCP tools implementation
│   ├── utils/          # Shared utilities
│   ├── main.ts         # Server entry point
│   └── types.ts        # Shared type definitions
├── tests/              # Test files
├── biome.json          # Linting configuration
├── tsconfig.json       # TypeScript configuration
└── package.json        # Project dependencies

⚙️ Konfiguration

Erstellen neuer Tools

Das Projekt enthält ein Skript zur Erstellung neuer MCP-Tools:

bun run scripts/create-tool.ts <tool-name>

Dies wird:

Erstellen Sie ein neues Tool-Verzeichnis unter src/tools/<tool-name>
Generieren Sie die grundlegende Werkzeugstruktur, einschließlich:
- index.ts (Hauptimplementierung)
- schema.ts (JSON-Schema für Tool-Parameter)
- test.ts (Testdatei)
Aktualisieren Sie die Indexdatei des Tools, um das neue Tool zu exportieren

Beispiel:

bun run scripts/create-tool.ts weather

🛠️ Entwicklung

Tests ausführen : bun test
Formatcode : bun run format
Lint-Code : bun run lint
Build-Projekt : bun run build

So fügen Sie Ihren Entwicklungs-MCP-Server zu Claude Desktop hinzu:

Erstellen Sie das Projekt:
bun run build
Fügen Sie Ihrer Claude Desktop-Konfiguration hinzu:
// You only need the argument if you need to pass arguments to your server { "mcpServers": { "your-server-name": { "command": "node", "args": ["/path/to/your/project/dist/main.js", "some_argument"] } } }

📜 Versionsverwaltung

Dieses Projekt verwendet die Standardversion für die automatisierte Versionsverwaltung. Führen Sie bun run release aus, um eine neue Version zu erstellen.

Commit-Nachrichtenformat

feat : Neue Funktion (verbessert Nebenversion)
fix : Fehlerbehebung (verbessert die Patch-Version)
BREAKING CHANGE : Breaking Change (erhöht die Hauptversion)

📦 Veröffentlichen auf npm

Stellen Sie sicher, dass Sie bei npm angemeldet sind:
npm login
Erstellen Sie das Projekt:
bun run build
Veröffentlichen Sie das Paket:
npm publish

Denken Sie daran, die Versionsnummer mit bun run release zu aktualisieren, bevor Sie neue Versionen veröffentlichen.

Installation von npm (nach der Veröffentlichung)

Fügen Sie Ihrer Claude Desktop-Konfiguration hinzu:

// You only need the argument if you need to pass arguments to your server
{
  "mcpServers": {
    "your-server-name": {
      "command": "npx",
      "args": ["-y", "your-package-name", "some_argument"]
    }
  }
}

MCP Server Starter

Integrations