Starstruk Logo MarkStarstruk

mcp-v1.0.0

getzep/graphitimcp-v1.0.0Oct 31, 2025by danielchalef

AI Summary

The major v1.0.0 release of the MCP Server introduces multi-provider support, a default entity ontology, and a modular Docker-based architecture.

Key Highlights

  • Introduced multi-provider support (OpenAI, Anthropic, Gemini, Groq, Azure) and FalkorDB/Neo4j databases
  • Added a default entity ontology with 9 preconfigured types (Preference, Requirement, etc.)
  • Simplified deployment with an all-in-one Docker image
  • Added health check endpoint for Docker and load balancer integration

Breaking Changes

  • Configuration - YAML is now the primary format (env vars still supported)
  • Default database - Changed to FalkorDB (use docker-compose-neo4j.yml for Neo4j)
  • Transport - SSE deprecated, use HTTP (default) or stdio
  • Dependencies - pytest and azure-identity moved to optional extras

New Features

  • Multi-provider support
  • Default entity ontology
  • YAML configuration
  • Enhanced node properties with custom attributes
  • Simplified deployment (all-in-one Docker image)
  • Health check endpoint

Full Release Notes

## 🆕 New Features

- **Multi-provider support** - OpenAI, Anthropic, Gemini, Groq, Azure LLMs; multiple embedders; FalkorDB or Neo4j databases
- **Default entity ontology** - 9 preconfigured entity types (Preference, Requirement, Procedure, Location, Event, Organization, Document, Topic, Object)
- **YAML configuration** - Type-safe config with environment variable expansion and CLI overrides
- **Enhanced node properties** - Complete entity metadata including custom attributes and all labels (embeddings excluded)

## âš¡ Improvements

- **Simplified deployment** - All-in-one Docker image with FalkorDB, or connect to external databases
- **Modular architecture** - Factory pattern for providers, separated service layers
- **Health check endpoint** - Proper `/health` endpoint for Docker and load balancers
- **Comprehensive testing** - 4,000+ lines of tests covering integration, async operations, stress/load scenarios

## 💥 Breaking Changes

- **Configuration** - YAML is now primary format (env vars still supported)
- **Default database** - Changed to FalkorDB (use `docker-compose-neo4j.yml` for Neo4j)
- **Transport** - SSE deprecated, use HTTP (default) or stdio
- **Dependencies** - `pytest` and `azure-identity` moved to optional extras

More in the [MCP Readme](mcp_server/README.md)