内容
# Mlytics CDN MCP 服务器
Mlytics CDN 网站和 DNS 记录管理的模型上下文协议（MCP）服务器实现。
## 概述
该 MCP 服务器提供了一组与 Mlytics API 交互的工具，允许您：
- 创建和管理 CDN 网站
- 检查网站状态
- 添加和列出 DNS 记录
- 更新域名设置
- 列出可用的 CDN 提供商
服务器实现了模型上下文协议，使其与支持该协议的 MCP 客户端和 AI 助手兼容。
## 安装
### 先决条件
- Node.js 18.0 或更高版本
- npm 或 yarn 包管理器
### 设置
1. 克隆仓库：
```bash
git clone https://github.com/mlytics/mlytics-bulldozer-mcp-server.git
cd mlytics-bulldozer-mcp-server
```
2. 安装依赖项：
```bash
npm install
```
3. 创建凭证文件：
在项目根目录中创建一个名为 `cred` 的文件，并添加您的 Mlytics API 密钥：
//mlytics apikey
your-api-key-here
## 使用
启动 MCP 服务器：
```bash
node mcp-server.js
```
服务器将启动并监听 stdin/stdout 上的 MCP 请求。
## 可用工具
MCP 服务器提供以下工具：
- `automated-login`：使用无头浏览器登录 Mlytics Portal 并提取 JWT token
- `show-credit-info`：显示已认证用户的当前信用额度使用信息
- `create-cdn-site`：创建新的 CDN 网站
- `check-site-status`：检查域名的状态
- `list-dns-records`：列出网站的所有 DNS 记录
- `add-dns-record`：向网站添加新的 DNS 记录
- `update-domain-settings`：更新域名的设置
- `list-cdn-providers`：列出所有可用的 CDN 提供商
- `list-sites`：列出所有 CDN 网站
- `query-cdn-edge-report`：查询域名的 CDN 边缘性能报告
- `get-historical-reports`：检索指定时间段内 DNS 查询的历史使用数据
- `query-guide`：从 Guide.md 文档中查询信息，并具有可自定义的输出格式
- `capacity-forecast`：生成具有历史分析、预测和建议的能力规划预测
有关每个工具的详细信息和使用方法，请参阅 [Guide.md](Guide.md) 文件。
## 身份验证方法
MCP 服务器支持两种身份验证方法：
1. **通过自动登录的 JWT Token（推荐）**：使用 `automated-login` 工具通过无头浏览器登录 Mlytics Portal。这会提取并存储一个 JWT token，用于后续的 API 调用。
```json
{
"email": "your-email@example.com",
"password": "your-password"
}
```
登录成功后，`show-credit-info` 等工具将自动使用存储的 JWT token。
2. **API 密钥（旧版）**：
- 从凭证文件：默认情况下，服务器从项目目录中的 `cred` 文件读取 API 密钥。
- 直接提供给工具：您可以在调用工具时通过包含 `apiKey` 参数直接提供 API 密钥。
## 贡献
欢迎贡献！请随时提交拉取请求。
## 许可证
该项目在 MIT 许可证下许可 - 有关详细信息，请参见 LICENSE 文件。
## 其他资源
- [Mlytics API 文档](https://developer.mlytics.com/v2.0/docs/getting-started)
- [模型上下文协议规范](https://github.com/modelcontextprotocol/spec)
## Claude 中的输出格式选项
在使用 Claude 与 MCP 服务器时，您可以为某些工具（例如 `query-guide` 工具）指定不同的输出格式。同样，Claude 本身支持通过各种接口使用时不同的渲染选项：
### Claude CLI 中的格式化选项
在使用 Claude CLI 时，您可以控制 Claude 响应的外观：
1. **默认终端输出**:
带有基本格式的标准文本输出。
2. **Markdown 渲染**:
大多数 Claude CLI 实现都渲染 markdown，允许：
- 标题（# for h1, ## for h2, 等）
- 列表（项目符号和编号）
- 具有语法高亮的代码块
- 表格
- 粗体和斜体文本
3. **纯文本**:
使用 `--no-markdown` 标志禁用 markdown 渲染。
4. **HTML 输出**:
一些 Claude CLI 实现可以输出 HTML，可以重定向到文件。
### 使用 `query-guide` 工具
`query-guide` 工具镜像了此功能，允许您指定以下格式：
- `text`：带有最小格式的纯文本
- `markdown`：以 markdown 格式的内容
- `html`：用于网页显示的 HTML 格式内容
- `json`：JSON 格式的结构化数据
示例：
```json
{
"section": "身份验证方法",
"format": "markdown"
}
```
此灵活性允许您以最适合您特定用例的格式获取信息。
MCP 市场