E

Eunomia

community
other

Extension of the Eunomia framework that connects Eunomia instruments with MCP servers

[!WARNING] This MCP server is deprecated as it is not compatible with the latest developments of Eunomia. A new MCP integration is under development and will be available soon.
<div align="center" style="margin-bottom: 1em;">
<img src="https://raw.githubusercontent.com/whataboutyou-ai/eunomia/be03ef57ade3686e6ae7e34227babbea2ae6a04d/docs/assets/logo.svg" alt="Eunomia Logo" width="300"></img>
Eunomia MCP Server
Open Source Data Governance for LLM-based Applications — with MCP integration
Made with ❤ by the team at What About You.
</div>

Overview

Eunomia MCP Server is an extension of the Eunomia framework that connects Eunomia instruments with MCP servers. It provides a simple way to orchestrate data governance policies (like PII detection or user access control) and seamlessly integrate them with external server processes in the MCP ecosystem.
With Eunomia MCP Server, you can:
  • Enforce data governance on top of LLM or other text-based pipelines.
  • Orchestrate multiple servers that communicate via the MCP framework.

Get Started

Installation

git clone https://github.com/whataboutyou-ai/eunomia-mcp-server.git

Basic Usage

Eunomia MCP Server uses the same "instrument" concept as Eunomia. By defining your set of instruments in an
Orchestra
, you can apply data governance policies to text streams that flow through your MCP-based servers.
Below is a simplified example of how to define application settings and run the MCP server with uv.
"""
Example Settings for MCP Orchestra Server
=========================================
This example shows how we can combine Eunomia with a web-browser-mcp-server
(https://github.com/blazickjp/web-browser-mcp-server).
"""

from pydantic_settings import BaseSettings
from pydantic import ConfigDict
from eunomia.orchestra import Orchestra
from eunomia.instruments import IdbacInstrument, PiiInstrument


class Settings(BaseSettings):
    """
    Application settings class for MCP orchestra server using pydantic_settings.

    Attributes:
        APP_NAME (str): Name of the application
        APP_VERSION (str): Current version of the application
        LOG_LEVEL (str): Logging level (default: "info")
        MCP_SERVERS (dict): Servers to be connected
        ORCHESTRA (Orchestra): Orchestra class from Eunomia to define data governance policies
    """

    APP_NAME: str = "mcp-server_orchestra"
    APP_VERSION: str = "0.1.0"
    LOG_LEVEL: str = "info"
    MCP_SERVERS: dict = {
        "web-browser-mcp-server": {
            "command": "uv",
            "args": [
                "tool",
                "run",
                "web-browser-mcp-server"
            ],
            "env": {
                "REQUEST_TIMEOUT": "30"
            }
        }
    }
    ORCHESTRA: Orchestra = Orchestra(
        instruments=[
            PiiInstrument(entities=["EMAIL_ADDRESS", "PERSON"], edit_mode="replace"),
            # You can add more instruments here
            # e.g., IdbacInstrument(), etc.
        ]
    )

Running the Server

Once your settings are defined, you can run the MCP Orchestra server by pointing
uv
to the directory containing your server code, for example:
uv --directory "path/to/server/" run orchestra_server
This will:
  1. Load the settings from
    .env
    or environment variables.
  2. Launch the Eunomia MCP Server to handle requests and orchestrate your external MCP server(s).
  3. Apply Eunomia instruments (like
    PiiInstrument
    ) to the incoming text, ensuring data governance policies are automatically enforced.

Further Reading

For more detailed usage, advanced configuration, and additional instruments, check out the following resources:

Related Servers

E

Everything

reference

Reference / test server with prompts, resources, and tools

View Details
M

Memory

reference

Knowledge graph-based persistent memory system

View Details
P

Puppeteer

reference

Browser automation and web scraping

View Details
S

Sentry

reference

Retrieving and analyzing issues from Sentry.io

View Details
S

Sequential Thinking

reference

Dynamic and reflective problem-solving through thought sequences

View Details