Hermeswhois MCP Server

MCP开发工具

提供方 KilimcininKorOglu

开发工具 stdio · 本地进程 Token 社区 / 第三方 Claude DesktopClaudeCursor
查看接入方式

提供域名WHOIS信息和SSL证书查询的MCP服务器,适用于开发者和网络管理员。

一句话选型结论

按资料字段整理

Hermeswhois MCP Server 属于开发工具类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude Desktop、Claude、Cursor,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 2 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量2暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

域名查询JavaScript混合部署SSL证书分析MCP服务器开发工具网络管理

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
docker run -d -p 3000:3000 hermeswhois-mcp-server

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 2 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 2 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Hermeswhois MCP Server当前 2 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方KilimcininKorOglu上游标注的维护方 KilimcininKorOglu
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.1 KB
来自项目仓库与上游目录的原文,未做删改

HermesWhois MCP Server

Model Context Protocol (MCP) sunucusu - HermesWhois servisi üzerinden domain WHOIS ve SSL sertifika bilgilerini sorgulama aracı.

Genel Bakış

Bu MCP sunucusu, Claude Desktop ve diğer MCP uyumlu uygulamalar için HermesWhois API'sine erişim sağlar. İki temel işlev sunar:

  1. WHOIS Sorgulama: Domain kayıt bilgileri, registrar detayları ve DNS yapılandırması
  2. SSL Sertifika Analizi: Sertifika geçerliliği, issuer bilgileri ve alternative names

Hızlı Kullanım (Code Mode)

MCP server'a bağlanmadan doğrudan script ile sorgulama yapabilirsiniz:```bash

WHOIS sorgusu

node scripts/hermeswhois-api.js whois google.com

SSL sorgusu

node scripts/hermeswhois-api.js ssl github.com

Her ikisi birden

node scripts/hermeswhois-api.js both cloudflare.com


> **Not**: Code Mode yaklaşımı token kullanımını %80-98 azaltır. Detaylar için: Cloudflare Code Mode Blog

## Teknik Özellikler

### WHOIS Sorgulama Yetenekleri

- Domain kayıt tarihi ve bitiş tarihi bilgileri
- Registrar ve kayıt URL'si
- Name server (DNS) konfigürasyonu
- DNSSEC durumu
- Domain statüsü ve transfer bilgileri
- Ham WHOIS verisi
- 12 saatlik cache mekanizması

### SSL Sertifika Sorgulama Yetenekleri

- Sertifika geçerlilik tarihleri
- Kalan süre hesaplama
- Issuer (Certificate Authority) bilgileri
- Sertifika serial number ve hash değerleri
- Subject Alternative Names (SAN) listesi
- Sertifika versiyonu
- 1 saatlik cache mekanizması

## Kurulum

### Gereksinimler

- Node.js 16.x veya üzeri
- npm veya yarn

### Kurulum Adımları```bash
# Bağımlılıkları yükleyin
npm install

# TypeScript kodunu derleyin
npm run build

Yapılandırma

IDE Entegrasyonları

Claude Desktop

Claude Desktop konfigürasyon dosyanızı (claude_desktop_config.json) düzenleyin:

Windows:```json
{
"mcpServers": {
"hermeswhois": {
"command": "node",
"args": ["C:\path\to\hermeswhois-mcp-server\build\index.js"]
}
}
}


**macOS / Linux:**```json
{
"mcpServers": {
"hermeswhois": {
"command": "node",
"args": ["/path/to/hermeswhois-mcp-server/build/index.js"]
}
}
}

Config dosyası konumu:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Cursor IDE

Cursor için MCP server konfigürasyonu .cursor/mcp.json dosyasına eklenir:

Global konfigürasyon (~/.cursor/mcp.json):```json
{
"mcpServers": {
"hermeswhois": {
"command": "node",
"args": ["/absolute/path/to/hermeswhois-mcp-server/build/index.js"]
}
}
}


**Proje bazlı konfigürasyon** (`.cursor/mcp.json` proje klasöründe):```json
{
"mcpServers": {
"hermeswhois": {
"command": "node",
"args": ["${workspaceFolder}/hermeswhois-mcp-server/build/index.js"]
}
}
}

Konum:

  • Windows: %USERPROFILE%\.cursor\mcp.json (global)
  • macOS/Linux: ~/.cursor/mcp.json (global)
  • Proje için: .cursor/mcp.json dosyasını proje kök dizininde oluşturun

Visual Studio Code

VSCode için MCP extension kurulumu:

  1. MCP extension'ı yükleyin
  2. Command Palette (Cmd/Ctrl + Shift + P) açın
  3. "MCP: Add Server" komutunu çalıştırın veya "MCP: Open User Configuration" ile manuel düzenleyin

User-level konfigürasyon (mcp.json):

Konum:

  • Windows: %APPDATA%\Code\User\mcp.json
  • macOS: ~/Library/Application Support/Code/User/mcp.json
  • Linux: `~/.config/Code/User/mcp.json````json
    {
    "mcpServers": {
    "hermeswhois": {
    "command": "node",
    "args": ["/absolute/path/to/hermeswhois-mcp-server/build/index.js"]
    }
    }
    }

**Workspace konfigürasyon** (`.vscode/mcp.json`):```json
{
"mcpServers": {
"hermeswhois": {
"command": "node",
"args": ["${workspaceFolder}/hermeswhois-mcp-server/build/index.js"]
}
}
}

Claude Code (CLI)

Claude Code için proje konfigürasyonu oluşturun:

.claude/mcp.json dosyası oluşturun:```json
{
"mcpServers": {
"hermeswhois": {
"command": "node",
"args": ["./build/index.js"]
}
}
}


Veya global kullanım için home directory'nizde:

**~/.claude/mcp.json**:```json
{
"mcpServers": {
"hermeswhois": {
"command": "node",
"args": ["/absolute/path/to/hermeswhois-mcp-server/build/index.js"]
}
}
}

Geliştirme Ortamı```bash

Watch mode - otomatik derleme

npm run watch

Development mode - ts-node ile çalıştırma

npm run dev

SSE server development mode

npm run dev:sse


## Web Deployment

MCP server'ı internet üzerinden yayınlamak için SSE (Server-Sent Events) transport kullanabilirsiniz.

### Hızlı Başlangıç```bash
# Dependencies yükleyin
npm install

# Build edin
npm run build

# SSE server'ı başlatın
npm run start:sse

Server http://localhost:3000/sse adresinde çalışacaktır.

Docker ile Deployment```bash

Docker image build edin

docker build -t hermeswhois-mcp-server .

Container'ı çalıştırın

docker run -d -p 3000:3000 hermeswhois-mcp-server


### Claude Desktop Bağlantısı (SSE)

Web üzerinden yayınlanan server için Claude Desktop config:```json
{
"mcpServers": {
"hermeswhois": {
"url": "https://mcp.hermeswhois.tr/sse"
}
}
}

Detaylı deployment bilgisi için: DEPLOYMENT.md

NPM Package

NPM'den Kurulum```bash

npm install -g hermeswhois-mcp-server


### Çalıştırma```bash
# Stdio mode (Claude Desktop için)
hermeswhois-mcp-server

NPM'e Yayınlama

Paketi NPM'e yayınlamak için: NPM_PUBLISH.md

MCP Tools Referansı

whois_lookup

Domain için WHOIS bilgilerini sorgular ve detaylı kayıt bilgilerini döndürür.

Parametreler

Parametre Tip Zorunlu Açıklama
domain string Evet Sorgulanacak domain adı (URL formatında da olabilir)

Kullanım Örneği```text

Query: Can you look up whois information for example.com?


#### Örnek Yanıt```text
=== HermesWhois Domain Lookup ===

Domain: example.com
Created: 1995-08-14
Expires: 2024-08-13
Updated: 2023-08-14
Status: clientDeleteProhibited clientTransferProhibited
Registrar: MarkMonitor Inc.
Registrar URL: http://www.markmonitor.com
Name Servers: a.iana-servers.net, b.iana-servers.net
DNSSEC: unsigned

Cache Status: true

=== Raw Whois Data ===
[Detaylı WHOIS verisi...]

ssl_lookup

Domain için SSL sertifika bilgilerini sorgular ve geçerlilik detaylarını döndürür.

Parametreler

Parametre Tip Zorunlu Açıklama
domain string Evet SSL sertifikası kontrol edilecek domain adı

Kullanım Örneği```text

Query: Check the SSL certificate for example.com


#### Örnek Yanıt```text
=== SSL Certificate Information ===

Domain: example.com
SSL Domain (CN): *.example.com
Valid From: 2024-01-15 10:30:00
Valid To: 2025-01-15 10:30:00
Days Until Expiry: 245 days

Issuer: Let's Encrypt Authority X3
Issuer Organization: Let's Encrypt

Serial Number: 03A1B2C3D4E5F6789012345678901234
Hash: a1b2c3d4
Version: 2

=== Subject Alternative Names ===
DNS:*.example.com
DNS:example.com
DNS:www.example.com

Cache Status: false

API Dokümantasyonu

WHOIS API

Endpoint: https://hermeswhois.tr/whois.php

HTTP Method: POST, GET

Request Format:```text
Content-Type: application/x-www-form-urlencoded
Body: domain=


**Response Format**: JSON

**Cache Duration**: 12 saat

**Response Schema**:```typescript
{
main: {
domain: string,
CreationDate: string,
ExpiryDate: string,
UpdatedDate: string,
SponsoringRegistrar: string,
RegistrarURL: string,
DomainStatus: string,
DNS: string,
DNSSEC: string,
// ... diğer alanlar
},
result: string,
whois: string,
cache: string
}

SSL API

Endpoint: https://hermeswhois.tr/ssl.php

HTTP Method: POST, GET

Request Format:```text
Content-Type: application/x-www-form-urlencoded
Body: domain=


**Response Format**: JSON

**Cache Duration**: 1 saat

**Response Schema**:```typescript
{
main: {
domain: string,
ssl_domain: string,
issuer: string,
issuer_organization: string,
valid_from_timestamp: number,
valid_to_timestamp: number,
serial_number: string,
hash: string,
version: number,
alt_names: string,
valid_from_date: string,
valid_to_date: string
},
result: string,
cache: string
}

Hata Yönetimi

WHOIS Sorguları

  • Invalid Domain: Geçersiz domain formatı
  • Domain is not registered: Domain kayıtlı değil
  • API Error: HermesWhois API hatası

SSL Sorguları

  • SSL Connection Failed: SSL bağlantısı kurulamadı
  • Invalid SSL Certificate: Geçersiz sertifika
  • HTTP error: API erişim hatası

Test

API Test Script'leri```bash

WHOIS API testi

node test-api.js

SSL API testi

node test-ssl.js


## Proje Yapısı```bash
hermeswhois-mcp-server/
├── src/
│   ├── index.ts          # Stdio transport (Claude Desktop)
│   └── server-sse.ts     # SSE transport (Web deployment)
├── scripts/
│   └── hermeswhois-api.js # Standalone API script (Code Mode)
├── build/                # Derlenmiş JavaScript dosyaları
├── test-api.js          # WHOIS API test script'i
├── test-ssl.js          # SSL API test script'i
├── skill.md             # TypeScript API tanımı (LLM için)
├── CLAUDE.md            # Claude Code rehberi
├── AGENTS.md            # AI agent rehberi
├── package.json         # NPM bağımlılıkları
├── tsconfig.json        # TypeScript yapılandırması
└── README.md            # Bu dosya

Teknik Detaylar

Kullanılan Teknolojiler

  • TypeScript: Tip güvenli geliştirme
  • @modelcontextprotocol/sdk: MCP protokol implementasyonu
  • node-fetch: HTTP istekleri için
  • Node.js: Runtime environment

Bağımlılıklar

Runtime Dependencies:

  • @modelcontextprotocol/sdk: ^1.0.4
  • node-fetch: ^3.3.2
  • express: ^4.18.2
  • cors: ^2.8.5

Development Dependencies:

  • @types/node: ^22.10.2
  • @types/express: ^4.17.21
  • @types/cors: ^2.8.17
  • ts-node: ^10.9.2
  • typescript: ^5.7.2

Code Mode

AI agent'lar için optimize edilmiş kullanım. MCP tool call overhead'i olmadan doğrudan API erişimi:

Dosya Açıklama
scripts/hermeswhois-api.js Standalone çalıştırılabilir script
skill.md TypeScript API tanımı (LLM context için)

Örnek Çıktı```bash

$ node scripts/hermeswhois-api.js whois cloudflare.com
json { "domain": "cloudflare.com", "creationDate": "2009-02-17", "expiryDate": "2033-02-17", "registrarUrl": "http://www.cloudflare.com", "dnssec": "signedDelegation", "cached": true }bash
$ node scripts/hermeswhois-api.js ssl github.com
```json { "domain": "github.com", "sslDomain": "github.com", "validFrom": "2025-02-05 03:00:00", "validTo": "2026-02-06 02:59:59", "daysUntilExpiry": 48, "expired": false, "issuer": "Sectigo ECC Domain Validation Secure Server CA", "cached": false }

> Referans: Cloudflare Code Mode Blog

Lisans

MIT License

Katkıda Bulunma

Bu proje açık kaynak değildir ve katkıya kapalıdır.

Destek

Sorularınız veya sorunlarınız için lütfen proje sahibi ile iletişime geçin.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Hermeswhois MCP Server 怎么安装?

在客户端按下面的安装命令接入:docker run -d -p 3000:3000 hermeswhois-mcp-server。装完在客户端配置里引用同一个包或端点。

Hermeswhois MCP Server 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Hermeswhois MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Hermeswhois MCP Server 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Hermeswhois MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Hermeswhois MCP Server 能提供哪些能力?

资料显示约 2 个工具;能力标签包括 开发工具、JavaScript、Claude、网络管理。具体工具清单以官方文档为准。

Hermeswhois MCP Server 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

Hermeswhois MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。