Quarkus Model Context Protocol (MCP) Server

Quarkus MCP Server

此 Quarkus 扩展提供声明式和编程式 API，使开发者能够轻松实现 MCP¹ 服务功能。

说明

LangChain4j 项目提供 MCP 客户端功能，既可以通过底层编程式 API 使用，也可以全面集成到 AI 应用中。

开始使用

第 1 步

将以下依赖项添加到你的 POM 文件中：

<dependency>
    <groupId>io.quarkiverse.mcp</groupId>
    <artifactId>quarkus-mcp-server-http</artifactId>
    <version>${quarkus-mcp-server-version}</version>
</dependency>

说明

此依赖项同时包含旧版“HTTP/SSE”和“Streamable HTTP”传输。如果要改用 STDIO 传输，请使用 quarkus-mcp-server-stdio artifactId。有关详细信息，请参阅文档中的传输部分。

第 2 步

添加服务功能（提示词、资源和工具），这些功能由 CDI Bean 的_带注解的业务方法_表示。

import jakarta.inject.Inject;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;

import io.quarkiverse.mcp.server.BlobResourceContents;
import io.quarkiverse.mcp.server.Prompt;
import io.quarkiverse.mcp.server.PromptArg;
import io.quarkiverse.mcp.server.PromptMessage;
import io.quarkiverse.mcp.server.Resource;
import io.quarkiverse.mcp.server.TextContent;
import io.quarkiverse.mcp.server.Tool;

// This class is automatically registered as a @Singleton CDI bean
public class MyFeatures {

    @Inject
    CodeService codeService;

    @Tool(description = "Converts the string value to lower case")
    String toLowerCase(String value) {
        return value.toLowerCase();
    }

    @Prompt(name = "code_assist")
    PromptMessage codeAssist(@PromptArg(name = "lang") String language) {
        return PromptMessage.withUserRole(new TextContent(codeService.assist(language)));
    }

    @Resource(uri = "file:///project/alpha.txt")
    byte[] alpha() throws IOException{
        return Files.readAllBytes(Path.of("alpha.txt"));
    }

}

第 3 步

运行 Quarkus 应用，尽情体验！

文档

完整文档请参阅 https://quarkiverse.github.io/quarkiverse-docs/quarkus-mcp-server/dev/index.html。

贡献者 ✨

感谢这些优秀的贡献者（表情符号说明）：

Martin Kouba 💻 🚧	Georgios Andrianakis 💻	Max Rydahl Andersen 💡	Rostislav Svoboda 💻	George Gastaldi 🚇	Jan Martiska 📖	Ioannis Canellos 💻
Sergey Beryozkin 💡	Konstantin Pavlov ⚠️ 🚇	Martijn van Duijnhoven 💻 ⚠️ 📖	Pierre Beitz 💻 ⚠️	Matthieu Recouly 📖	Willem Jan Glerum 🚇	Sascha Steffen 💻 ⚠️
Clement Escoffier 📖	Rolfe Dlugy-Hegwer 📖 💻	Bruno Baptista 📖 💻	Moayad Alyaghshi 🐛 💻	David Kornel 🐛 💻	Ian Stewart 🐛 💻	Eric Hare 🐛 💻
Nagi KaTou 🐛 💻	Matej Novotny 🐛 ⚠️ 💻

本项目遵循 all-contributors 规范。欢迎以任何形式参与贡献！

Footnotes

1. "Model Context Protocol（MCP）是一种开放协议，可在大模型应用与外部数据源和工具之间实现无缝集成。" ↩