Poop Mcp Server

Poop MCP Server

Poop MCP Server 为 AI 工具提供 MCP（Model Control Protocol）服务。此服务通过标准化协议，使 AI 模型能够与外部服务交互。

功能

• 3D 场景命令服务：处理 3D 环境中的移动命令
• 加密货币价格服务：使用 CoinGecko API 获取实时加密货币价格
• Spring AI 集成：基于 Spring AI 的工具框架构建，可无缝集成 AI 模型
• Docker 支持：通过 Docker 轻松部署

前置条件

• Java 17 或更高版本
• Maven 3.6 或更高版本
• Docker（可选，用于容器化部署）
• CoinGecko API 密钥（用于加密货币价格服务）

安装和设置

克隆代码仓库

git clone https://github.com/AlienMCP/poop-mcp-server.git
cd poop-mcp-server

环境变量

在项目根目录中创建 .env 文件，并填写以下变量：

COINGECKO_API_KEY=your_api_key_here

构建应用

mvn clean package -DskipTests

使用方法

本地运行

java -jar target/poop-mcp-server-0.0.1-SNAPSHOT.jar

服务默认在端口 8888 上启动。

配置文件

应用支持三个配置文件：

• dev（默认）：开发环境
• test：测试环境
• prod：生产环境

使用指定配置文件运行：

java -jar target/poop-mcp-server-0.0.1-SNAPSHOT.jar --spring.profiles.active=prod

配置

应用属性

主要配置位于 application.yaml 中：

spring:
  ai:
    mcp:
      server:
        name: poop-mcp-server
        version: 0.0.1
  profiles:
    active: '@profile.name@'
server:
  port: 8888

特定环境的配置位于：

• application-dev.yaml
• application-test.yaml
• application-prod.yaml

Docker 部署

构建 Docker 镜像

mvn clean package -DskipTests
docker build -t poop-mcp-server:latest .

运行 Docker 容器

docker run -p 8888:8888 -e COINGECKO_API_KEY=your_api_key_here poop-mcp-server:latest

API 文档

3D 场景命令服务

3D 场景命令服务提供在 3D 环境中处理移动命令的功能。

处理移动命令

processMoveCommand(command, target, distance)

• command：命令类型（仅支持 "move"）
• target：方向（"front"、"back"、"left"、"right"）
• distance：移动距离（正数）

返回包含命令详情的 JSON 字符串，或错误消息。

加密货币价格服务

加密货币价格服务提供获取实时加密货币价格的功能。

获取加密货币价格

fetchCryptoPrice(coin)

• coin：加密货币的官方全名（例如，"bitcoin"、"ethereum"）

返回包含加密货币价格详情的 JSON 字符串，或错误消息。

Spring AI 集成

此服务旨在与 Spring AI 的工具框架配合使用。服务使用 @ToolServer 注解，方法使用 @Tool 注解，以便将其作为工具提供给 AI 模型。