wren-engine

# Wren Engine: The Semantic Core for Model Context Protocol (MCP)

## The Challenge: Bridging the Gap Between LLMs and Enterprise Data

Large Language Models (LLMs) hold immense potential for revolutionizing enterprise workflows. However, effectively leveraging LLMs in complex business environments requires more than just raw data access. Businesses need AI that can:

*   **Understand** the nuances of their data models.
*   **Execute** trusted calculations and aggregations.
*   **Interpret** business terms with precision.
*   **Adhere** to user-based permissions and access controls.

## Our Solution: Wren Engine - A Semantic Engine for the MCP Ecosystem

Wren Engine is designed to address these challenges by providing a robust semantic layer for Model Context Protocol (MCP) clients and AI agents. As a key component of the MCP ecosystem, Wren Engine empowers AI to access and interact with enterprise data with accuracy, context, and governance.

<p align="center">
  <img src="./misc/mcp_wren_engine.webp" alt="Wren Engine and MCP Integration">
</p>

## Key Features and Benefits

*   **Embeddable:** Seamlessly integrates into any MCP client or AI agent workflow.
*   **Interoperable:** Works with modern data stacks like PostgreSQL, MySQL, and Snowflake.
*   **Semantic-First:** Enables AI to "understand" your data model and business logic.
*   **Governance-Ready:** Respects roles, access controls, and data definitions.

## Getting Started with MCP

Explore the [MCP Server README](mcp-server/README.md) to begin building context-aware AI applications.

## Core Concepts

*   **Semantic SQL with Apache DataFusion:** [Powering Semantic SQL for AI Agents with Apache DataFusion](https://getwren.ai/post/powering-semantic-sql-for-ai-agents-with-apache-datafusion)
*   **Quick Start Guide:** [Quick start with Wren Engine](https://docs.getwren.ai/oss/engine/get_started/quickstart)
*   **Understanding Semantics:** [What is semantics?](https://docs.getwren.ai/oss/engine/concept/what_is_semantics)
*   **Modeling Definition Language (MDL):** [What is Modeling Definition Language (MDL)?](https://docs.getwren.ai/oss/engine/concept/what_is_mdl)
*   **Benefits of Wren Engine with LLMs:** [Benefits of Wren Engine with LLMs](https://docs.getwren.ai/oss/engine/concept/benefits_llm)

## Project Status

Wren Engine is currently in beta, with bi-weekly releases planned.

## Developer Guides

The project is structured into four main modules:

1.  **ibis-server:** Web server powered by FastAPI and Ibis.
2.  **wren-core:** Semantic core written in Rust, powered by Apache DataFusion.
3.  **wren-core-py:** Python binding for wren-core.
4.  **mcp-server:** MCP server powered by the MCP Python SDK.

## Community

*   **Discord:** Join our [Discord server](https://discord.gg/5DvshJqG8Z) to provide feedback and connect with the community.
*   **GitHub Issues:** Report issues and contribute to the project on [Github Issues](https://github.com/Canner/wren-engine/issues).