Whodis MCP-Server

Dieses Projekt bietet einen Model Context Protocol (MCP)-Server, der speziell für die Überprüfung der Verfügbarkeit von Domänennamen mithilfe von WHOIS-Suchen entwickelt wurde. KI-Assistenten und andere Tools können damit die Verfügbarkeitsprüfung von Domänen in ihre Arbeitsabläufe integrieren.

Überblick

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Systemen ermöglicht, sich sicher und kontextbezogen mit externen Tools und Datenquellen zu verbinden. Dieser Server implementiert den MCP-Standard, um Informationen zur Domänenverfügbarkeit bereitzustellen.

Related MCP server: WebSearch-MCP

Merkmale

• Überprüfung der Domänenverfügbarkeit : Verwendet die whoiser -Bibliothek, um WHOIS-Suchen durchzuführen und festzustellen, ob Domänen verfügbar oder registriert zu sein scheinen.

• MCP-Tool-Integration : Stellt ein Tool check-domain-availability für MCP-Clients (wie KI-Assistenten) bereit.

• CLI-Schnittstelle : Enthält eine Befehlszeilenschnittstelle ( whodis-mcp-server check-domain-availability ... ) zur direkten Verwendung und zum Testen.

• Strukturierte Protokollierung : Bietet detaillierte Protokollierung zum Debuggen und Überwachen.

• Konfigurierbar : Unterstützt die Konfiguration über Umgebungsvariablen oder .env Dateien.

Erste Schritte

Voraussetzungen

• Node.js (>=18.x): Herunterladen

• Git : Zur Versionskontrolle

Schritt 1: Klonen und installieren

# Clone the repository
git clone https://github.com/vinsidious/whodis-mcp-server.git
cd whodis-mcp-server

# Install dependencies
npm install

Schritt 2: Entwicklungsserver ausführen

Starten Sie den Server im Entwicklungsmodus, um über den MCP Inspector mit ihm zu interagieren:

npm run dev:server

Dadurch wird der MCP-Server gestartet und der MCP Inspector unter http://localhost:5173 aktiviert, wo Sie das Tool check-domain-availability testen können.

Schritt 3: Testen Sie das Tool über die CLI

Führen Sie den Domänenverfügbarkeitsprüfer direkt über die Befehlszeile aus:

# Using CLI in development mode
npm run dev:cli -- check-domain-availability example.com non-existent-domain-12345.org

# Or run the built version
npm run start:cli -- check-domain-availability google.com my-unique-idea.dev

Die CLI gibt ein JSON-Objekt aus, das available und unavailable Arrays enthält.

Architektur

Dieser Server folgt einer Schichtenarchitektur:

src/
├── cli/              # Command-line interface logic
├── controllers/      # Business logic for domain checks
├── services/         # Interaction with the whoiser library
├── tools/            # MCP tool definition and argument validation
├── types/            # Shared type definitions
├── utils/            # Shared utilities (logging, errors, etc.)
└── index.ts          # Main entry point for server and CLI

Entwicklungshandbuch

Entwicklungsskripte

# Start MCP server in development mode (with MCP Inspector)
npm run dev:server

# Run CLI commands in development mode
npm run dev:cli -- check-domain-availability <domains...>

# Build the project for production
npm run build

# Start MCP server in production mode (requires MCP client)
npm run start:server

# Run CLI commands using the production build
npm run start:cli -- check-domain-availability <domains...>

Testen

# Run all tests
npm test

# Generate test coverage report
npm run test:coverage

Codequalität

# Lint code
npm run lint

# Format code with Prettier
npm run format

MCP-Tool: check-domain-availability

• ZWECK : Überprüft die Verfügbarkeit eines oder mehrerer Domänennamen.

• EINGABE : Ein Array von Domänennamen.

  {
  	"domains": ["example.com", "another-domain.net"]
  }

• AUSGABE : Ein JSON-Objekt mit zwei Arrays: available (Domänen, die offenbar nicht registriert sind) und unavailable (Domänen, die offenbar registriert sind).

  {
  	"available": ["likely-available-domain123.xyz"],
  	"unavailable": ["google.com"]
  }

  Hinweis : Verfügbarkeitsprüfungen hängen von den Antworten des WHOIS-Servers ab und sind möglicherweise nicht für alle TLDs oder aufgrund vorübergehender Netzwerkprobleme 100 % genau. Domänen, bei denen die Suche fehlgeschlagen ist, werden nicht berücksichtigt.

• WANN ZU VERWENDEN : Verwenden Sie dieses Tool, wenn Sie feststellen müssen, ob bestimmte Domänennamen möglicherweise registriert werden können.

Debuggen

MCP-Inspektor

Greifen Sie auf den visuellen MCP-Inspektor zu, um das Tool zu testen und Anforderungs-/Antwortdetails anzuzeigen:

1. Führen Sie npm run dev:server

2. Öffnen Sie http://localhost:5173 in Ihrem Browser

3. Verwenden Sie die Benutzeroberfläche, um das Tool check-domain-availability aufzurufen.

Serverprotokolle

Aktivieren Sie Debug-Protokolle für eine detaillierte Ausgabe:

# Set environment variable
DEBUG=true npm run dev:server

# Or set DEBUG=true in your .env file

Protokolle werden auch in Dateien in ~/.mcp/data/whodis-mcp-server.*.log gespeichert.

Veröffentlichen

So veröffentlichen Sie Updates an npm:

1. Stellen Sie sicher, dass die Änderungen festgeschrieben werden und den herkömmlichen Festschreibungsnachrichten folgen (z. feat: , fix: , chore: ).

2. Übertragen Sie Änderungen in den main .

3. Der Workflow ci-semantic-release.yml erstellt, testet, versioniert und veröffentlicht das Paket automatisch auf npm.

Lizenz

ISC-Lizenz