Poop Mcp Server
@AlienMCP
Poop MCP Server provides an MCP (Model Control Protocol) server for AI tools. This server enables AI models to interact with external services through a standardized protocol.
Overview
What is Poop Mcp Server?
Poop Mcp Server is an MCP (Model Context Protocol) server that enables AI tools to interact with external services through a standardized protocol. It provides a 3D Scene Command Service for processing movement commands and a Cryptocurrency Price Service that fetches real-time prices via the CoinGecko API, built with Spring AI’s tool framework.
How to use Poop Mcp Server?
Clone the repository, set the COINGECKO_API_KEY environment variable, build with mvn clean package -DskipTests, and run the JAR locally (java -jar target/poop-mcp-server-0.0.1-SNAPSHOT.jar) or deploy using Docker. The server starts on port 8888 by default and supports three profiles: dev, test, and prod. Services are exposed as AI-usable tools via Spring AI annotations.
Key features of Poop Mcp Server
- 3D Scene Command Service for movement commands
- Cryptocurrency Price Service using CoinGecko API
- Built with Spring AI’s tool framework
- Docker support for containerized deployment
- Environment-specific profiles (dev, test, prod)
- CoinGecko API key required for crypto service
Use cases of Poop Mcp Server
- AI agents processing 3D movement commands in a simulated environment
- AI models fetching real-time cryptocurrency prices by coin name
- Integrating external services into AI workflows via MCP protocol
- Deploying an MCP server in containerized environments with Docker
FAQ from Poop Mcp Server
What are the prerequisites to run Poop Mcp Server?
Java 17 or higher, Maven 3.6 or higher, and a CoinGecko API key. Docker is optional for containerized deployment.
What is the default port and how can I change it?
The server starts on port 8888 by default. Port can be configured in application.yaml under server.port.
What profiles does Poop Mcp Server support?
It supports three profiles: dev (default), test, and prod. Use --spring.profiles.active=<profile> to switch.
What commands are supported by the 3D Scene Command Service?
Only the "move" command is supported. It requires a target direction (front, back, left, right) and a positive distance number.
What coin names should be used for the Cryptocurrency Price Service?
Use the official full name of the cryptocurrency, e.g., "bitcoin" or "ethereum". The service returns a JSON string with price details or an error message.
