Poop Mcp Server

by AlienMCP

163 downloads

Not rated

GitHub

Other

About

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.

Details

Author: AlienMCP
Downloads: 163
Categories: Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Poop Mcp Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "poop mcp server": {
            "poop-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "poop-mcp-server:latest",
                    "."
                ]
            }
        }
    }
}

McpServers

{
    "poop-mcp-server": {
        "command": "docker",
        "args": [
            "build",
            "-t",
            "poop-mcp-server:latest",
            "."
        ]
    }
}

Poop MCP Server

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.

Features

- 3D Scene Command Service: Process movement commands in a 3D environment
- Cryptocurrency Price Service: Fetch real-time cryptocurrency prices using the CoinGecko API
- Spring AI Integration: Built with Spring AI's tool framework for seamless AI model integration
- Docker Support: Easy deployment with Docker

Prerequisites

- Java 17 or higher
- Maven 3.6 or higher
- Docker (optional, for containerized deployment)
- CoinGecko API key (for cryptocurrency price service)

Installation and Setup

Clone the Repository

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

Environment Variables

Create a .env file in the project root with the following variables:

COINGECKO_API_KEY=your_api_key_here

Build the Application

mvn clean package -DskipTests

Usage

Running Locally

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

The server will start on port 8888 by default.

Profiles

The application supports three profiles:

- dev (default): Development environment
- test: Testing environment
- prod: Production environment

To run with a specific profile:

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

Configuration

Application Properties

The main configuration is in application.yaml:

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

Environment-specific configurations are in:
- application-dev.yaml
- application-test.yaml
- application-prod.yaml

Docker Deployment

Build Docker Image

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

Run Docker Container

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

API Documentation

3D Scene Command Service

The 3D Scene Command Service provides functionality to process movement commands in a 3D environment.

Process Move Command

processMoveCommand(command, target, distance)

- command: The command type (only "move" is supported)
- target: The direction ("front", "back", "left", "right")
- distance: The distance to move (positive number)

Returns a JSON string with the command details or an error message.

Cryptocurrency Price Service

The Cryptocurrency Price Service provides functionality to fetch real-time cryptocurrency prices.

Fetch Crypto Price

fetchCryptoPrice(coin)

- coin: The official full name of the cryptocurrency (e.g., "bitcoin", "ethereum")

Returns a JSON string with the cryptocurrency price details or an error message.

Spring AI Integration

This server is designed to work with Spring AI's tool framework. Services are annotated with @ToolServer and methods with @Tool to make them available as tools for AI models.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Poop MCP Server

Features

Prerequisites

Installation and Setup

Clone the Repository

Environment Variables

Build the Application

Usage

Running Locally

Profiles

Configuration

Application Properties

Docker Deployment

Build Docker Image

Run Docker Container

API Documentation

3D Scene Command Service

Process Move Command

Cryptocurrency Price Service

Fetch Crypto Price

Spring AI Integration

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀