agentic-ai

Agentic AI MCP Server is a Spring Boot application that provides AI-powered dog adoption scheduling services. It is packaged as a Docker image for easy deployment, and can also be run locally with Maven and Java. Once started, the server runs on a configurable port (default 8081) and exposes its capabilities via standard Spring Boot endpoints. Use Docker to run the pre-built image, or build locally to run the JAR file with Java. If you need to expose a different port, you can set the SERVER_PORT environment variable when starting the container (for example, to use 8082 instead of 8081). This server focuses on coordinating adoption scheduling with AI-assisted logic, enabling streamlined interactions for dog adoption workflows.

Prerequisites:

• Docker (recommended for quick setup)
• Java 21 and Maven 3.9+ if you prefer building locally

Option 1: Install and run with Docker

1. Build or pull the Docker image (if you have a prebuilt image, you can skip the build step): docker build -t agentic-ai-mcp-server .

2. Run the container (default port 8081): docker run -p 8081:8081 agentic-ai-mcp-server

3. (Optional) Override the port using SERVER_PORT, for example to 8082: docker run -p 8082:8082 -e SERVER_PORT=8082 agentic-ai-mcp-server

Option 2: Run locally (build from source)

1. Prerequisites: Java 21 and Maven 3.9+.

2. Build the project: mvn clean package

3. Run the packaged JAR: java -jar target/agentic-ai-mcp-server-0.0.1-SNAPSHOT.jar

4. By default, the server will listen on port 8081. To change the port, set SERVER_PORT in your environment before launching the app, or pass the appropriate JVM/system properties as needed.

Notes:

• The default service port is 8081; you can override it with the SERVER_PORT environment variable when using Docker.
• Docker is the recommended deployment method per the README; the image name used in instructions is agentic-ai-mcp-server.
• If you build locally, ensure you are using Java 21 and Maven 3.9+ as specified in the development prerequisites.
• When mapping ports in Docker, ensure the host port is available and not already in use by another service.
• No npm package is specified for this server (null npm package in this documentation).