agenthost

agenthost MCP 服务

agenthost 是面向 Agent 的网页托管服务，完全通过 MCP 服务驱动。本仓库包含它在 MCP Registry 中的条目 — server.json — 以及发布该条目的工作流。

agenthost 是一个远程 MCP 服务：由 agenthost 托管，可通过 Streamable HTTP 在 https://agenthost.eu/mcp 访问。无需在本地安装任何内容。

• Registry 名称： eu.agenthost/agenthost
• 端点： https://agenthost.eu/mcp（Streamable HTTP）
• 网站： https://agenthost.eu

服务代码本身位于 agenthost 的私有控制面板仓库中；本仓库仅包含公开的 Registry 元数据。

连接

将任何支持 Streamable HTTP 的 MCP 客户端指向 https://agenthost.eu/mcp。身份验证由客户端的 OAuth 流程处理 — 你可以在浏览器中登录或注册 agenthost，因此无需粘贴令牌。对于无法打开浏览器的无人值守客户端，agenthost 可以生成长期有效的 API 令牌，通过 Bearer 标头发送。

客户端配置示例：

{
  "mcpServers": {
    "agenthost": {
      "type": "streamable-http",
      "url": "https://agenthost.eu/mcp"
    }
  }
}

发布

发布通过 GitHub Actions 自动完成 (.github/workflows/publish-mcp.yml)。Registry 条目使用 eu.agenthost 命名空间 — 即 agenthost.eu 的反向 DNS 格式 — 并通过 DNS 身份验证证明所有权：在 agenthost.eu 的顶级域名上设置 TXT 记录，存放 Ed25519 签名密钥的公钥部分；工作流则使用存储在 MCP_PRIVATE_KEY 密钥中的私钥部分进行签名。

• 每次推送和拉取请求都会根据官方架构验证 server.json（mcp-publisher validate）— 无需密钥。
• 推送 v* 标签（或手动运行工作流）即可向 Registry 发布。使用标签发布时，发布的版本取自该标签，因此 git 标签是 Registry 版本的唯一事实来源。

发布新版本：

git tag v0.1.0
git push origin v0.1.0

之后进行验证：

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=eu.agenthost/agenthost"

一次性 DNS 身份验证设置

在可信的机器上生成签名密钥（需要 OpenSSL 3+），确保私钥不会离开你的控制：

# 1. Generate an Ed25519 key pair
openssl genpkey -algorithm Ed25519 -out key.pem

# 2. Build the DNS TXT record (public key)
PUBLIC_KEY="$(openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64)"
echo "agenthost.eu. IN TXT \"v=MCPv1; k=ed25519; p=${PUBLIC_KEY}\""

# 3. Extract the private key for the GitHub secret
openssl pkey -in key.pem -noout -text | grep -A3 'priv:' | tail -n +2 | tr -d ' :\n'; echo

然后：

1. 添加第 2 步中的 TXT 记录，将其设置在 agenthost.eu 的顶级域名上（agenthost.eu，而非 _mcp-auth 子域名）。等待记录传播。
2. 将第 3 步中的私钥添加为名为 MCP_PRIVATE_KEY 的仓库密钥（Settings → Secrets and variables → Actions）。为了加强保护，可将其存储在名为 mcp-registry-publish 的 GitHub Environment 中，并将该环境限制为默认分支和发布标签 — 工作流已引用此环境。
3. 存储密钥后，删除 key.pem。

如果轮换密钥，请从顶级域名中删除旧 TXT 记录 — 系统会优先尝试过期记录，导致验证失败。

编辑 server.json

server.json 遵循 MCP Registry 的 server.schema.json（$schema 字段固定了确切版本）。确保 remotes[].url 与生产端点保持一致，并确保 description 不超过架构规定的 100 个字符。CI 会验证每项更改，因此格式错误的修改会在审核时失败。