porkbun-dns-mcp

MCP运维云端

提供方 lesleslie

运维云端 stdio · 本地进程 API Key 社区 / 第三方 ClaudeCodex
查看接入方式

Manages Porkbun domain DNS records with lookup, creation, editing, and deletion through a FastMCP interface, for development and automated operations scenarios.

一句话选型结论

按资料字段整理

porkbun-dns-mcp 属于运维云端类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude、Codex,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

Local DeploymentPorkbunDNS Management

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
uv run porkbun-dns-mcp start

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Codex,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
porkbun-dns-mcp当前 未标注 stdio · 本地进程 本地部署 有 2026-09-27
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

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

详细介绍

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

Porkbun DNS MCP Server

MCP server for managing Porkbun DNS records through a FastMCP interface.

Version: 0.2.0
Status: Standalone FastMCP server

Quick Links

  • Overview
  • Capabilities
  • Quick Start
  • MCP Server Configuration
  • Tool Reference
  • Configuration
  • Development

Quality & CI

Crackerjack is the standard quality-control and CI/CD gate for Porkbun DNS MCP changes. Local verification should mirror the Crackerjack workflow.


Overview

Porkbun DNS MCP exposes DNS record management workflows through a FastMCP server. It is focused on record lookup, creation, update, and deletion for domains managed through Porkbun while keeping provider credentials and request validation in a narrow integration boundary.

This server is intentionally separate from porkbun-domain-mcp. DNS owns record-level operations; domain owns registration, renewal, transfer, and pricing workflows.

Capabilities

Implemented tool surface (the first 5 bullets are MCP tools registered via
@app.tool(); the last two are HTTP endpoints / internal helpers, not MCP tools —
see the Tool Reference and Health Checks
sections for the exact surface):

  • Record listing: list all DNS records for a domain
  • Record lookup: retrieve a specific DNS record by ID
  • Record creation: create A, AAAA, CNAME, MX, TXT, NS, SRV, CAA, or ALIAS records
  • Record editing: update selected fields on an existing DNS record
  • Record deletion: remove a DNS record by ID
  • Credential health metadata: PorkbunDNSSettings.has_credentials() reports whether API credentials are configured (internal helper, not an MCP tool)
  • HTTP health routes: /health and /healthz for MCP client and process supervision checks (Starlette routes, not MCP tools)

Quick Start

Prerequisites

  • Python 3.13+
  • UV package manager
  • Porkbun API key and secret key

Local Setup```bash

git clone https://github.com/lesleslie/porkbun-dns-mcp.git
cd porkbun-dns-mcp
uv sync --group dev


### Run With Credentials```bash
export PORKBUN_DNS_API_KEY="your-api-key"
export PORKBUN_DNS_SECRET_KEY="your-secret-key"
uv run porkbun-dns-mcp start
uv run porkbun-dns-mcp health

The default HTTP bind is 127.0.0.1:3042.

CLI Commands

The CLI is built with mcp-common and provides the standard lifecycle command surface used by FastMCP servers.```bash
uv run porkbun-dns-mcp start # Start the HTTP MCP server
uv run porkbun-dns-mcp stop # Stop the managed server process
uv run porkbun-dns-mcp restart # Restart the managed server process
uv run porkbun-dns-mcp status # Show process status
uv run porkbun-dns-mcp health # Run the local health probe


## MCP Server Configuration

### Claude / Codex Style Configuration

Add the server to an MCP client configuration:```json
{
  "mcpServers": {
    "porkbun-dns": {
      "command": "uv",
      "args": ["run", "porkbun-dns-mcp", "start"],
      "cwd": "/Users/les/Projects/porkbun-dns-mcp",
      "env": {
        "PORKBUN_DNS_API_KEY": "your-api-key",
        "PORKBUN_DNS_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Use your secret manager for live credentials rather than committing them to client config.

Health Checks```bash

curl http://127.0.0.1:3042/health
curl http://127.0.0.1:3042/healthz


## Installation via Claude Code marketplace

This repo ships a Claude Code plugin manifest (`.claude-plugin/plugin.json`) plus a colocated `.mcp.json` and three slash commands in `commands/`. To install, register the www-mcp-servers marketplace with Claude Code, then install the plugin by name. Once installed, the slash commands `/porkbun-dns-records`, `/porkbun-dns-list`, and `/porkbun-dns-create` become available alongside the `mcp__porkbun-dns__*` tools.

## Tool Reference

| Tool | Purpose | Required Inputs |
|------|---------|-----------------|
| `list_dns_records` | List all DNS records for a domain | `domain` |
| `get_dns_record` | Retrieve one DNS record by ID | `domain`, `record_id` |
| `create_dns_record` | Create a DNS record | `domain`, `record_type`, `name`, `content` |
| `edit_dns_record` | Update selected fields on a DNS record | `domain`, `record_id` |
| `delete_dns_record` | Delete a DNS record | `domain`, `record_id` |

Supported record types are `A`, `AAAA`, `CNAME`, `MX`, `TXT`, `NS`, `SRV`, `CAA`, and `ALIAS`.

Tool responses follow a consistent `ToolResponse` shape:```json
{
  "success": true,
  "message": "Found 4 DNS records for example.com",
  "data": {},
  "error": null,
  "next_steps": []
}

Configuration

Committed defaults live in settings/porkbun-dns.yaml. Runtime overrides should come from environment variables or a local .env file that is not committed.

Setting Environment Variable Default
API key PORKBUN_DNS_API_KEY empty
Secret key PORKBUN_DNS_SECRET_KEY empty
Base URL PORKBUN_DNS_BASE_URL https://porkbun.com/api/json/v3
Timeout PORKBUN_DNS_TIMEOUT 30.0
Max retries PORKBUN_DNS_MAX_RETRIES 3
HTTP host PORKBUN_DNS_HTTP_HOST 127.0.0.1
HTTP port PORKBUN_DNS_HTTP_PORT 3042
Log level PORKBUN_DNS_LOG_LEVEL INFO
JSON logs PORKBUN_DNS_LOG_JSON true
Enable HTTP transport PORKBUN_DNS_ENABLE_HTTP_TRANSPORT false

Project Structure```text

porkbun_dns_mcp/
cli.py # mcp-common lifecycle CLI
client.py # Porkbun DNS API client boundary
config.py # Pydantic settings and logging
models.py # Typed DNS record models
server.py # FastMCP application factory
tools/dns_tools.py # Registered MCP tools
settings/
porkbun-dns.yaml # Committed defaults
tests/
test_schema_validation.py


## Development```bash
uv sync --group dev
uv run pytest
uv run ruff check porkbun_dns_mcp tests
uv run ruff format porkbun_dns_mcp tests
uv run pyright porkbun_dns_mcp

Use targeted tests when isolating schema behavior:bash uv run pytest tests/test_schema_validation.py -v

Security Notes

  • Do not commit Porkbun API keys, secret keys, real customer domains, or sensitive record values.
  • Treat DNS mutations as production-impacting operations.
  • Review generated delete_dns_record and edit_dns_record calls before exposing them to unattended agent workflows.
  • Scrub real domain details from fixtures, screenshots, and troubleshooting logs.

Built on Oneiric for runtime configuration
and mcp-common for the FastMCP
baseline. Crackerjack gates every commit.

常见问题

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

在客户端按下面的安装命令接入:uv run porkbun-dns-mcp start。装完在客户端配置里引用同一个包或端点。

porkbun-dns-mcp 怎么在 Claude、Codex 里配置?

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

porkbun-dns-mcp 收费吗?

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

porkbun-dns-mcp 需要 API Key 吗?

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

porkbun-dns-mcp 支持哪些客户端?

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

porkbun-dns-mcp 能提供哪些能力?

资料显示能力标签包括 Local Deployment、Porkbun、DNS Management、Python、Domain Management、MCP Server。具体工具清单以官方文档为准。

porkbun-dns-mcp 需要什么运行环境?

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

porkbun-dns-mcp 是本地还是远程?

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

热门专题

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

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