pahangkrisdyan-mcp-server

基本能力

产品定位

pahangkrisdyan-mcp-server 是一个基于 Quarkus 框架的 MCP 服务器项目，旨在为开发者提供快速构建和部署 MCP 服务器的能力。

核心功能

1. 开发模式运行：支持实时编码和快速开发。
2. 本地可执行文件生成：通过 Gradle 构建本地可执行文件。
3. Docker 镜像构建和运行：支持从本地可执行文件生成 Docker 镜像并运行。
4. MCP 服务器特性：支持 HTTP/SSE 协议，便于开发者实现 MCP 服务器功能。

适用场景

1. 快速开发：适用于需要快速迭代和实时编码的开发场景。
2. 云原生部署：适用于需要在云原生或容器化环境中部署 MCP 服务器的场景。
3. 本地测试：适用于本地测试和调试 MCP 服务器功能。

工具列表

1. Quarkus Dev UI：在开发模式下提供开发者界面，便于调试和监控。
2. Gradle：用于构建项目和生成本地可执行文件。
3. Docker：用于构建和运行 Docker 镜像。

常见问题解答

1. 如何访问 Dev UI？：在开发模式下，访问 http://localhost:8080/q/dev/。
2. 如何构建本地可执行文件？：使用 ./gradlew build 命令并启用本地构建选项。
3. 如何构建 Docker 镜像？：使用 docker build 命令并指定 Dockerfile。

使用教程

使用依赖

1. 确保已安装 Java JDK 和 Gradle。
2. 确保已安装 Docker（如需构建 Docker 镜像）。

安装教程

1. 克隆项目： shell git clone <repository-url> cd pahangkrisdyan-mcp-server

2. 运行开发模式： shell ./gradlew quarkusDev

3. 构建本地可执行文件： shell ./gradlew build -Dquarkus.package.jar.enabled=false -Dquarkus.native.enabled=true -Dquarkus.native.container-build=true -Dquarkus.native.builder-image=quay.io/quarkus/ubi-quarkus-mandrel-builder-image:jdk-21.0.5

4. 构建 Docker 镜像： shell docker build -f src/main/docker/Dockerfile.native-micro -t quarkus/pahangkrisdyan-mcp-server .

5. 运行 Docker 镜像： shell docker run -i --rm -p 8080:8080 quarkus/pahangkrisdyan-mcp-server

调试方式

1. 访问 Dev UI：在浏览器中打开 http://localhost:8080/q/dev/。
2. 查看日志：在运行开发模式或 Docker 容器时，查看控制台输出日志。
3. 测试接口：使用工具如 curl 或 Postman 测试 MCP 服务器的 HTTP/SSE 接口。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。