内容
# 🚀 Akamai 函数 MCP 服务器
[](https://github.com/ThorstenHans/akamai-functions-mcp-server/actions)
[](https://goreportcard.com/report/github.com/ThorstenHans/akamai-functions-mcp-server)
[](https://github.com/spinframework/spin)
在您的 AI 助手中解锁 **Akamai 函数** 的强大功能。此 MCP（模型上下文协议）服务器允许 Claude Desktop 或 Cursor 等工具使用自然语言与您的边缘应用程序交互。
---
## 🛑 前置条件
在将服务器添加到您的 AI 客户端之前，请确保您的本地环境已准备就绪：
1. **已安装插件**：您需要用于 Spin 的 `aka` 插件：
```bash
spin plugins update
spin plugins install aka --yes
```
2. **需要登录**：您必须通过 `aka` 插件登录 `spin`:
```bash
spin aka login
```
---
## 📦 安装
> 注意：如果您使用的是 Homebrew（`brew`）以外的安装方法，请将 `akamai-functions-mcp` 添加到您的 `PATH` 变量中。
### 使用 Homebrew 安装（推荐）
通过添加 Akamai 开发者 tap 并安装公式，使用 Homebrew 进行安装：
```bash
brew tap akamai-developers/tap
brew install akamai-developers/tap/akamai-functions-mcp
```
<p align="center">
<img alt="通过 Homebrew 安装 Akamai 函数 MCP 服务器" src="./assets/install_via_brew.gif" width="70%">
</p>
### 下载预编译的二进制文件
如果 Homebrew 不可用（例如在 Windows 上），请从[最新版本](https://github.com/akamai-developers/akamai-functions-mcp-server/releases/latest)下载预编译的二进制文件。
### 从源代码构建
使用 Go 在本地构建二进制文件：
```bash
go build -o akamai-functions-mcp main.go
```
## ⚙️ 配置
要让您的 AI 助手使用服务器，请将 `spin` 命令添加到您的配置中。如需启用调试日志记录，请在 `args` 数组中追加 `--debug` 标志。
### Claude Desktop
更新您的 `claude_desktop_config.json`（位于 macOS 上的 `~/Library/Application Support/Claude/` 或 Windows 上的 `%APPDATA%\Claude\`）：
```json
{
"mcpServers": {
"akamai-functions": {
"command": "akamai-functions-mcp",
"args": []
}
}
}
```
### Cursor / VS Code
- 导航到设置 > MCP
- 点击 + 添加服务器
- 名称：`Akamai 函数 MCP 服务器`
- 类型：`command`
- 命令：`akamai-functions-mcp`
- 参数：
### Zed
从命令调色板中，选择 `agent: add context server` 操作，提供以下 JSON 配置，并通过按 `Add Server` 保存配置：
```json
{
"Akamai 函数 MCP 服务器": {
"command": "akamai-functions-mcp",
"args": [],
"env": {}
}
}
```
## 🤖 示例交互
您的 AI 现在可以作为您的边缘基础设施的技术助手。尝试询问：
- "显示我在 'staging' 账户中的所有应用程序。"
- "'edge-api' 应用程序的当前状态和 URL 是什么？"
- "检查 'image-processor' 的日志，查找任何 404 错误。"
- "列出我可用的 Akamai 函数账户。"
## 🛠 可用工具
| 工具 | 描述 |
| ---- | ----------- |
| `list_accounts` | 获取与您的登录关联的所有 Akamai 函数账户。 |
| `list_apps` | 已部署应用程序的清单（可按账户/名称过滤）。 |
| `get_app_status` | 详细的健康状况、部署历史和活动 URL。 |
| `get_app_url` | 获取部署到 Akamai 函数的应用程序的公共 URL |
| `get_app_logs` | 实时执行日志检索。 |
| `get_app_history` | 获取部署到 Akamai 函数的应用程序的部署历史 |
| `search_app` | 根据搜索词（`query`）查找应用程序。此命令会遍历您有权访问的所有 Akamai 函数账户 |
| `deploy_app` | 将应用程序部署到 Akamai 函数。 |
| `link_app` | 将当前本地工作区链接到现有的 Akamai 函数应用程序。 |
| `unlink_app` | 删除本地工作区与部署到 Akamai 函数的现有应用程序之间的链接。 |
## 可用资源 📄
- `spin aka` 命令参考 - 以 markdown 格式返回完整的命令参考。
