
Quarkus Model Context Protocol (MCP) Server

2025.04.16
0
JavaLLM 集成开发工具开发效率
Quarkus Model Context Protocol (MCP) Server 是一个基于 Quarkus 的扩展,旨在简化开发者实现 MCP 服务器功能的过程。MCP 是一个开放协议,用于实现 LLM 应用程序与外部数据源和工具的无缝集成。该扩展提供了声明式 API,使开发者能够轻松地添加服务器功能,如提示、资源和工具。
View on GitHub
Overview
基本能力
产品定位
Quarkus MCP Server 是一个用于简化 MCP 服务器功能实现的 Quarkus 扩展,专注于 LLM 应用程序与外部数据源和工具的集成。
核心功能
- 声明式 API:通过注解方式快速定义服务器功能(如提示、资源和工具)。
- HTTP/SSE 传输支持:目前仅支持 Server-Sent Events (SSE) 传输协议。
- CDI 集成:自动注册为 CDI bean,方便依赖注入和管理。
- 工具和资源管理:支持定义工具(如文本处理)和资源(如文件读取)。
适用场景
- LLM 应用集成:为 LLM 应用程序提供外部数据源和工具的无缝集成。
- 开发效率提升:通过声明式 API 快速构建 MCP 服务器功能。
- 资源管理:管理外部资源(如文件、API)并将其暴露给 LLM 应用程序。
工具列表
@Tool
:用于定义工具方法,例如文本处理(如转换为小写)。@Prompt
:用于定义提示方法,例如代码辅助功能。@Resource
:用于定义资源方法,例如读取文件内容。
常见问题解答
- 支持的传输协议:目前仅支持 HTTP/SSE。
- 依赖管理:需通过 Maven 添加依赖。
- CDI 集成:自动注册为 CDI bean,无需额外配置。
使用教程
使用依赖
- 在项目的
pom.xml
文件中添加以下依赖:
<dependency>
<groupId>io.quarkiverse.mcp</groupId>
<artifactId>quarkus-mcp-server</artifactId>
<version>${project-version}</version>
</dependency>
安装教程
- 添加依赖后,创建一个 CDI bean 并定义服务器功能(如工具、提示或资源)。
- 使用
@Tool
、@Prompt
或@Resource
注解标注方法。 - 运行 Quarkus 应用程序。
调试方式
- 启动 Quarkus 应用程序后,可以通过日志查看 MCP 服务器的启动状态。
- 使用 HTTP 客户端测试 SSE 端点,验证功能是否正常工作。
- 检查 CDI bean 是否被正确注册和注入。