feat: Add OpenAPI 3.1 spec and MCP server binary#225
Merged
Conversation
ZPascal
force-pushed
the
feature/ai-agent-support
branch
from
6d4dca2 to
ef87060
Compare
ZPascal
force-pushed
the
feature/dns-api-extended
branch
from
e929f6d to
c941f89
Compare
ZPascal
force-pushed
the
feature/ai-agent-support
branch
from
ef87060 to
da3ae59
Compare
ZPascal
changed the title
ZPascal
force-pushed
the
feature/dns-api-extended
branch
3 times, most recently
from
c4045a1 to
360a8ae
Compare
ZPascal
force-pushed
the
feature/dns-api-extended
branch
3 times, most recently
from
4d70ec0 to
14501d8
Compare
ZPascal
changed the title
ZPascal
force-pushed
the
feature/ai-agent-support
branch
from
da3ae59 to
0251b9d
Compare
* feat: Add MCP server config loading (file + env vars) * feat: Add MCP tool definitions and HTTP proxy logic * feat: Serve OpenAPI 3.1 spec at GET /openapi.json * feat: Add MCP binary stdio entry point with JSON-RPC 2.0 protocol * fix: surface acme-dns API errors as MCP tool failures, harden mcp binary * docs: Document the MCP server and OpenAPI endpoint; expand mcp test coverage Signed-off-by: Pascal Zimmermann <pascal.zimmermann@theiotstudio.com>
ZPascal
force-pushed
the
feature/ai-agent-support
branch
from
8a9e8bc to
6e0a253
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
GET /openapi.json(no auth required)POST /register,POST /update,GET /health, and the admin record CRUD endpointscmd/acme-dns-mcp/binary: stdio-based MCP server wrapping the acme-dns HTTP API as structured toolsregister_subdomain,update_txt_record,list_dns_records,create_dns_record,update_dns_record,delete_dns_record,health_check~/.acme-dns-mcp/config.tomlor env vars (ACMEDNS_BASE_URL,ACMEDNS_ADMIN_TOKEN, etc.).goreleaser.ymlupdated to build and publishacme-dns-mcpalongsideacme-dnsTest Plan
go test -race ./...passesgo build ./...builds cleanlyGET /openapi.jsonreturns valid OpenAPI 3.1 JSONhealth_checktool returns{"status":"ok"}against a running instancelist_dns_recordsreturns{"records":[...]}with admin token configured{"error":"admin_token not configured"}All items above were verified end-to-end against a locally running acme-dns instance with
cmd/acme-dns-mcpcommunicating over stdio.