Quarkus MCP 工具服务器

项目简介

'ai-agent-protocols' 仓库旨在深入探讨构建现代互联 AI 代理的协议和框架。其中，'quarkus-db-store-mcp' 子项目是一个基于 Quarkus 框架实现的 Model Context Protocol (MCP) 服务器。该服务器的核心功能是提供一个标准化的接口，允许 AI 代理通过调用其暴露的工具来执行特定任务，例如将数据持久化到数据库。

主要功能点

MCP 服务器实现: 提供了符合 MCP 协议规范的服务器端功能，支持通过 JSON-RPC 协议进行通信（在此示例中通过 SSE 传输协议）。
数据库存储工具: 暴露了一个名为 'store-product-brief-in-database' 的工具。此工具接收产品名称和详细描述作为输入，并模拟将其存储到数据库的操作（实际实现中为日志记录）。
AI 代理集成: 可作为 LLM 驱动的 AI 代理（例如使用 Google Agent Development Kit (ADK) 构建的代理）的后端服务，为它们提供可调用的外部功能，从而扩展 AI 代理的能力。

安装步骤

在本地运行此 MCP 服务器的步骤如下：

克隆仓库: 打开终端，执行以下命令克隆 'ai-agent-protocols' 仓库：

git clone https://github.com/glaforge/ai-agent-protocols.git
cd ai-agent-protocols

进入 MCP 服务器项目目录: 导航到 'quarkus-db-store-mcp' 子项目目录：
```
cd quarkus-db-store-mcp
```
启动 MCP 服务器:
- 确保您的系统已安装 Java 开发工具包 (JDK) 和 Gradle 构建工具。
- 执行以下命令以开发模式启动服务器。这将使服务器在代码更改时自动重新加载，便于开发和测试：
```
./gradlew quarkusDev
```
- 服务器成功启动后，将监听 'http://localhost:8080' 地址，并通过 'http://localhost:8080/mcp/sse' 端点提供 MCP 服务。

服务器配置

以下是该 MCP 服务器的配置信息，MCP 客户端可以据此建立连接并发现其提供的工具。这些信息描述了服务器的能力和连接方式，也包含了客户端在需要时启动服务器的命令和参数。

{
  "server_name": "Quarkus MCP DB存储服务",
  "description": "一个基于 Quarkus 框架实现的 MCP 服务器，提供标准化工具接口，支持 AI 代理存储数据到数据库。",
  "command": "java",
  "args": [
    "-jar",
    "build/quarkus-app/quarkus-run.jar",
    "-Dquarkus.http.port=8080"
  ],
  "command_notes": "上述 'command' 和 'args' 描述了如何以独立 JAR 包形式运行 MCP 服务器。在执行此命令前，需确保已在 'quarkus-db-store-mcp' 目录下通过 './gradlew build' 命令生成了可执行的 'build/quarkus-app/quarkus-run.jar' 文件。",
  "connection_info": {
    "url": "http://localhost:8080/mcp/sse",
    "protocol": "SSE"
  },
  "available_tools": [
    {
      "name": "store-product-brief-in-database",
      "description": "存储产品简报到数据库，接收产品名称和描述作为输入。",
      "parameters": {
        "product_name": {
          "type": "string",
          "description": "待存储产品的名称"
        },
        "product_description": {
          "type": "string",
          "description": "待存储产品的详细描述"
        }
      },
      "returns": {
        "type": "object",
        "description": "操作结果，包含成功或错误信息。",
        "properties": {
          "message": {
            "type": "string",
            "description": "操作结果消息，例如 'Product saved.' 或错误详情。"
          }
        }
      }
    }
  ]
}

基本使用方法

一旦 MCP 服务器在 'http://localhost:8080' 成功启动，任何兼容 MCP 协议的 AI 代理客户端都可以通过配置连接到 'http://localhost:8080/mcp/sse'。客户端随后可以通过 JSON-RPC 请求调用服务器暴露的 'store-product-brief-in-database' 工具。例如，一个产品策略 AI 代理可以调用此工具来保存新产品的概念和详细信息。

关键词