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.

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:

Führen Sie npm run dev:server
Öffnen Sie http://localhost:5173 in Ihrem Browser
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:

Stellen Sie sicher, dass die Änderungen festgeschrieben werden und den herkömmlichen Festschreibungsnachrichten folgen (z. feat: , fix: , chore: ).
Übertragen Sie Änderungen in den main .
Der Workflow ci-semantic-release.yml erstellt, testet, versioniert und veröffentlicht das Paket automatisch auf npm.

Lizenz

ISC-Lizenz

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Ein Model Context Protocol-Server, der es KI-Assistenten ermöglicht, die Verfügbarkeit von Domänennamen mithilfe von WHOIS-Lookups zu überprüfen.

Related MCP Servers

Whois MCP
bharathvaj-ganesan
A
security
A
license
A
quality
A Model Context Protocol server that allows AI agents to perform WHOIS lookups, enabling users to directly ask the AI about domain availability, ownership, registration details, and other domain information.
Last updated -
4
2,853
30
JavaScript
MIT License
WebSearch-MCP
mnhlt
A
security
F
license
A
quality
A Model Context Protocol server that enables AI assistants to perform real-time web searches, retrieving up-to-date information from the internet via a Crawler API.
Last updated -
1
297
14
JavaScript
MCP-Censys
nickpending
-
security
F
license
-
quality
A Model Context Protocol server that enables natural language querying of the Censys Search API for domain, IP, and FQDN reconnaissance, providing information about hosts, DNS, certificates, and services in real-time.
Last updated -
3
Python
MCP Advisor
istarwyh
A
security
A
license
A
quality
A discovery and recommendation service that helps AI assistants find Model Context Protocol servers based on natural language queries.
Last updated -
445
53
TypeScript
MIT License

View all related MCP servers

Whodis MCP Server