dviluk/animo-mcp-server

Animo MCP Server

Model Context Protocol server for the Food Safety Platform. Provides standardized tool interfaces for AI agents (GPT-4o, Claude, etc.) to interact with the data hub and inference services.

Architecture

• Protocol: MCP (Model Context Protocol) via JSON-RPC 2.0
• Framework: FastAPI + uvicorn
• Authentication: JWT (shared secret with Laravel)
• Tools: 50+ document, database, and workflow tools

Quick Start

Prerequisites

• Python 3.12+
• Docker and Docker Compose
• PostgreSQL 14+
• Redis 7+

Local Development

1. Clone and setup:

cd animo-mcp-server
python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Configure environment:

cp .env.example .env
# Edit .env with your credentials

3. Run server:

python main.py

4. Verify:

curl http://localhost:5002/health
# Expected: {"status":"healthy",...}

Docker Compose

1. Build and start:

docker-compose up --build

2. Verify:

docker-compose ps
curl http://localhost:5002/health

Project Structure

animo-mcp-server/
├── main.py              # Entry point
├── server.py            # FastAPI app
├── config.py            # Configuration
├── requirements.txt     # Dependencies
├── Dockerfile
├── docker-compose.yml
├── tools/              # MCP tool implementations
├── schemas/            # JSON Schema definitions
├── middleware/         # Auth, rate limiting
├── services/           # Business logic
└── tests/              # Test suite

Configuration

See .env.example for all configuration options.

Required:

• JWT_SECRET - Shared with Laravel for authentication
• POSTGRES_* - Database connection details

Development

Run tests:

pytest

Type checking:

mypy .

Code formatting:

black .
isort .

Next Steps

• Implement MCP protocol handler (Task 002)
• Add tool registry and validation (Task 003)
• Implement authentication middleware (Task 004)

Documentation

• MCP Specification

License

Proprietary - Animo Food Safety Platform