MCP-сервер Headless Domains

Официальный сервер Model Context Protocol (MCP) для Headless Domains. Этот сервер предоставляет операции API Headless Domains для MCP-совместимых клиентов, таких как Claude Desktop, Cursor и Windsurf.

Функции

• search_domain: проверка доступности домена

• lookup_whois: просмотр информации о зарегистрированном домене

• register_domain: регистрация домена с использованием API-ключа

• sync_bio: синхронизация биографии агента/профиля с использованием API-ключа

• Автоматический выбор транспорта:

  • stdio для локальных MCP-клиентов

  • sse при наличии переменной PORT для развернутых серверов

Требования

• Python 3.10+

• Опционально: API-ключ Headless Domains для аутентифицированных инструментов

Локальная настройка

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Переменные окружения

Локальный запуск

Для локального MCP-клиента сервер по умолчанию использует stdio:

python server.py

Вы также можете запустить его через MCP CLI:

mcp run server.py

Конфигурация Claude Desktop

Добавьте запись сервера в claude_desktop_config.json:

{
  "mcpServers": {
    "headlessdomains": {
      "command": "mcp",
      "args": [
        "run",
        "/absolute/path/to/headlessdomains-mcp/server.py"
      ],
      "env": {
        "HEADLESSDOMAINS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Если вам пока не нужны аутентифицированные инструменты, вы можете пропустить HEADLESSDOMAINS_API_KEY.

Развернутый режим SSE

Когда задан PORT, server.py автоматически запускает транспорт SSE:

PORT=8080 python server.py

Типичный запуск в стиле Railway:

HOST=0.0.0.0 PORT=8080 python server.py

Примечания к инструментам

register_domain

• Требует HEADLESSDOMAINS_API_KEY

• Отправляет базовую полезную нагрузку, содержащую domain, namespace, years, agreed_to_terms (true) и payment_method ("gems")

• Принимает extra_payload_json для полей API, не жестко закодированных в инструменте

Пример:

{
  "domain": "myagent.agent",
  "years": 1,
  "extra_payload_json": "{\"owner_email\":\"me@example.com\"}"
}

sync_bio

• Требует HEADLESSDOMAINS_API_KEY

• Синхронизирует данные с эндпоинтом /domains/<domain>/bio

• Отправляет domain, bio и bio_markdown

• Принимает extra_payload_json для любых дополнительных полей API (таких как name, x, github и т. д.)

Пример:

{
  "domain": "myagent.agent",
  "bio_markdown": "# About Me",
  "extra_payload_json": "{\"name\":\"My Agent Name\", \"x\":\"twitter_handle\"}"
}

Docker

Сборка:

docker build -t headlessdomains-mcp .

Запуск:

docker run --rm -p 8080:8080 \
  -e PORT=8080 \
  -e HEADLESSDOMAINS_API_KEY=your-api-key-here \
  headlessdomains-mcp

Дымовое тестирование

После установки зависимостей:

python -m py_compile server.py
python - <<'PY'
import server
print(server.search_domain("example.agent"))
print(server.lookup_whois("test.agent"))
PY

Примечания

• /temp-specs игнорируется в .gitignore, чтобы локальные документы планирования не попадали в систему контроля версий.