域名DNS管理服务器

git clone https://github.com/myroslavtryhubets/porkbun-mcp.git
cd porkbun-mcp

make install
# Or manually:
cp .env.example .env

PORKBUN_API_KEY=your_api_key_here
PORKBUN_SECRET_API_KEY=your_secret_api_key_here

make build
make up

make test
# Or manually:
curl http://localhost:8000/health
curl http://localhost:8000/

MCP_SERVERS='{"porkbun":{"url":"http://localhost:8000/porkbun/mcp","name":"Porkbun Domain & DNS","type":"streamable-http","instructions":"You are an assistant with access to Porkbun domain and DNS management. Use these tools to help users manage their domains, configure DNS records, set up URL forwarding, and maintain domain security. Always confirm destructive operations before executing."}}'

mcpServers:
  porkbun:
    url: "http://localhost:8000/porkbun/mcp"
    name: "Porkbun Domain & DNS"
    type: streamable-http  # Use 'type', not 'transport'
    instructions: |
      You are an assistant with access to Porkbun domain and DNS management.
      
      Available capabilities:
      - Domain management (list, check availability, nameservers)
      - DNS record management (create, edit, delete A/AAAA/CNAME/MX/TXT/etc.)
      - URL forwarding setup
      - Glue record management
      - DNSSEC configuration
      - SSL certificate retrieval
      
      Always confirm destructive operations (delete, bulk operations) with the user first.
    timeout: 120000

{
  "mcpServers": {
    "porkbun": {
      "url": "http://localhost:8000/porkbun/mcp",
      "transport": "http"
    }
  }
}

User: "Is example.com available for registration?"
Assistant: [Uses porkbun_check_domain]

User: "Show me all my domains"
Assistant: [Uses porkbun_list_domains]

User: "Add an A record for www.example.com pointing to 1.2.3.4"
Assistant: [Uses porkbun_create_dns_record with domain="example.com", record_type="A", content="1.2.3.4", name="www"]

User: "Forward old-site.com to https://new-site.com with a permanent redirect"
Assistant: [Uses porkbun_add_url_forward with domain="old-site.com", location="https://new-site.com", forward_type="permanent"]

User: "What are the DNS records for example.com?"
Assistant: [Uses porkbun_retrieve_dns_records]

porkbun-mcp/
├── src/
│   ├── __init__.py          # Package initialization
│   ├── main.py              # FastAPI app with MCP integration
│   └── models.py            # Pydantic configuration models
├── services/
│   ├── __init__.py
│   └── client.py            # Porkbun API client
├── ci/
│   └── semver.json          # Version metadata
├── Dockerfile               # Container build configuration
├── docker-compose.yml       # Service orchestration
├── requirements.txt         # Python dependencies
├── Makefile                 # Convenience commands
├── .env.example             # Environment template
├── .gitignore              # Git ignore rules
└── README.md               # This file

make help       # Show all available commands
make build      # Build Docker image
make up         # Start server
make down       # Stop server
make restart    # Restart server
make logs       # View server logs
make clean      # Remove containers and images
make test       # Test server endpoints
make install    # Create .env from template

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Create .env file with your credentials
cp .env.example .env
# Edit .env with your API keys

# Run the server
python -m src.main

%(asctime)s - %(name)s - %(levelname)s - %(message)s

make logs