π The fast, Pythonic way to build MCP servers and clients.
Introduce Eunomia Middleware docs
tommitt37415dfa1e13
diff --git a/docs/docs.json b/docs/docs.jsonindex e3526069e..ed970a434 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -130,6 +130,7 @@"integrations/claude-desktop","integrations/gemini","integrations/openai",+ "integrations/eunomia-middleware","integrations/contrib"]},diff --git a/docs/integrations/eunomia-middleware.mdx b/docs/integrations/eunomia-middleware.mdxnew file mode 100644index 000000000..e1d5dd481--- /dev/null+++ b/docs/integrations/eunomia-middleware.mdx@@ -0,0 +1,108 @@+---+title: Eunomia Authorization + FastMCP+sidebarTitle: Eunomia Authorization+description: Add policy-based authorization to your FastMCP servers+icon: layer-group+tag: NEW+---++Add **policy-based authorization** to your FastMCP servers with minimal code changes using Eunomia authorization middleware.++Control which actions MCP clients can perform on your server by restricting how the agent can access resources, tools and prompts by using JSON-based policies, while obtaining a comprehensive audit log of all access attempts and violations.++## Eunomia Authorization Middleware++The middleware intercepts all MCP requests to your server and automatically maps MCP methods to authorization checks.++```mermaid+sequenceDiagram+ participant MCPClient as MCP Client+ participant EunomiaMiddleware as Eunomia Middleware+ participant MCPServer as FastMCP Server+ participant EunomiaServer as Eunomia Server++ MCPClient->>EunomiaMiddleware: MCP Request+ Note over MCPClient, EunomiaMiddleware: Middleware intercepts request to server+ EunomiaMiddleware->>EunomiaServer: Authorization Check+ EunomiaServer->>EunomiaMiddleware: Authorization Decision (allow/deny)+ EunomiaMiddleware-->>MCPClient: MCP Unauthorized Error (if denied)+ EunomiaMiddleware->>MCPServer: MCP Request (if allowed)+ MCPServer-->>MCPClient: MCP Response (if allowed)+```++<Note>+Eunomia is an AI-specific standalone authorization server that handles policy decisions. You must have an Eunomia server running alongside your FastMCP server for the middleware to function.++Run it in the background with Docker:++```bash+docker run -d -p 8000:8000 ttommitt/eunomia-server:latest+```++</Note>++### Create a Server with Authorization++First, install the `eunomia-mcp` package:++```bash+pip install eunomia-mcp+```++Then create a FastMCP server and add the Eunomia middleware with a few lines of code:++```python server.py+from fastmcp import FastMCP+from eunomia_mcp import create_eunomia_middleware++mcp = FastMCP("Secure FastMCP Server π")++def add(a: int, b: int) -> int:+ """Add two numbers"""+ return a + b++middleware = [create_eunomia_middleware()]+app = mcp.http_app(middleware=middleware)++if __name__ == "__main__":+ import uvicorn+ uvicorn.run(app, host="0.0.0.0", port=8080)+```++### Configure Access Policies++Use the `eunomia-mcp` CLI in your terminal to manage your authorization policies:++```bash+# Create a default policy configuration file+eunomia-mcp init+```++This creates a policy file you can customize to control access to your MCP tools and resources.++```bash+# Once ready, validate your policy+eunomia-mcp validate mcp_policies.json++# And push it to the Eunomia server+eunomia-mcp push mcp_policies.json+```++### Run the Server++Start your FastMCP server normally:++```bash+python server.py+```++The middleware will now intercept all MCP requests and check them against your policies. Requests include agent identification through headers like `X-Agent-ID`, `X-User-ID`, or `Authorization` and an automatic mapping of MCP methods to authorization resources and actions.++<Tip>+ For detailed policy configuration, custom authentication, and advanced+ deployment patterns, visit the [Eunomia MCP Middleware+ repository][eunomia-github].+</Tip>++[eunomia-github]: https://github.com/whataboutyou-ai/eunomia/tree/main/pkgs/extensions/mcp