AI工具API服务器

Akto MCP Server是一个基于Spring Boot的模型上下文协议(MCP)服务器,旨在提供AI驱动的工具和API,支持与Akto交互,并可通过Docker容器化部署。

  • by akto-api-security
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 akto-api-security/akto-mcp-server

使用说明

Akto MCP服务器

Akto MCP Server是一个基于Spring Boot的模型上下文协议(MCP)服务器,旨在提供AI驱动的工具和API与Akto交互。它利用了Spring AI,并为易于部署做好了容器准备。

特性

  • 弹簧靴3.4.5 应用
  • 模型上下文协议(MCP) 通过Spring AI提供支持
  • 码头工人 支持容器化部署

先决条件

  • Java 17+
  • Maven 3.8+
  • Docker(可选,用于容器化部署)
  • 一 AKTO_API_KEY 环境变量(必需)

入门指南

1.克隆存储库

git clone <repo-url>
cd akto-mcp-server

2.建设项目

./mvnw clean package

3.运行服务器

当地:

export AKTO_API_KEY=your_api_key
java -jar target/mcp-1.0.jar

注: 生成您的 AKTO_API_KEY,请按照 Akto API参考.

使用Docker:

docker build -t akto-mcp-server .
docker run --rm -i -e AKTO_API_KEY=your_api_key akto-mcp-server

与MCP客户端(Claude、Cursor等)集成

您可以将Akto MCP服务器连接到任何兼容MCP的客户端,如Claude、Cursor等。这些客户端通常需要一个配置,指定如何访问您的MCP服务器。

以下是与MCP客户端集成的示例配置:

{
  "mcpServers": {
    "akto-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--name akto-mcp-server",
        "-i",
        "-e",
        "AKTO_API_KEY",
        "akto-api-security/akto-mcp-server:latest"
      ],
      "env": {
        "AKTO_API_KEY": "your_api_key"
      }
    }
  }
}
  • 替换 your_api_key 使用您的实际Akto API密钥。
  • 此配置允许客户端自动启动并连接到Akto MCP服务器。

有关此配置的确切位置和格式,请参阅MCP客户端的文档。

MCP客户端配置示例

光标

现行方法(截至2025年):

  • 光标会 不 为MCP服务器使用标准配置文件。相反,您必须通过Cursor应用程序UI添加MCP服务器:
    1. 打开光标。
    2. 首选 设置.
    3. 导航到 主控程序 选项卡。
    4. 点击 添加新的全局MCP服务器.
    5. 将MCP服务器JSON配置(上面的块)粘贴到对话框中。
    6. 点击 保存 或 刷新 以激活服务器。

注: Cursor中当前没有MCP服务器的基于文件的配置。所有配置都通过UI进行管理。

参考:


克劳德桌面

配置文件位置:

  • 在…上 macOS:
    ~/Library/Application Support/Claude/claude_desktop_config.json
  • 在…上 视窗:
    %APPDATA%\Claude\claude_desktop_config.json

步骤:

  1. 打开 claude_desktop_config.json 在您首选的文本编辑器中创建文件。
  2. 添加或更新 "mcpServers" 使用服务器配置的部分:
    {
      "mcpServers": {
        "akto-mcp-server": {
          "command": "docker",
          "args": [
            "run",
            "--rm",
            "--name akto-mcp-server",
            "-i",
            "-e",
            "AKTO_API_KEY",
            "akto-api-security/akto-mcp-server:latest"
          ],
          "env": {
            "AKTO_API_KEY": "your_api_key"
          }
        }
      }
    }
    
  3. 保存文件并重新启动Claude Desktop。

故障排除

  • 如果服务器未出现,请确保您的JSON有效,并重新启动应用程序。
  • 对于Cursor,始终使用UI,因为不支持基于文件的配置。
  • 对于Claude,请确保您正在为您的操作系统编辑正确的文件。