Model Context Protocol (MCP) Server Adapter for TrueRag GraphQL Policies

This repository furnishes a Model Context Protocol (MCP) server implementation designed to interface with a GraphQL endpoint providing policy access. For details on MCP, see https://modelcontextprotocol.io/introduction.

The core functionality relies on the official Python SDK for MCP and utilizes the GQL utility for GraphQL endpoint interaction.

Quick Setup Guide

Repository Acquisition

Clone the source code repository:

bash git clone https://github.com/Ad-Veritas/mcp-server-trueRAG.git cd mcp-server-trueRAG

Dependency Management with uv

Ensure you have the uv package installer available:

bash uv --version

If missing, installation instructions follow:

bash

For Unix-like systems (macOS/Linux).

curl -LsSf https://astral.sh/uv/install.sh | sh

For Windows via PowerShell.

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Configuration Initialization

The adapter is pre-configured to target a GraphQL API associated with a TrueRag infrastructure. After provisioning your TrueRAG environment, secure the provided API key and service endpoint URL.

Establish a .env file in the project root and populate it with the required credentials:

txt GRAPHQL_API_KEY = "{your_api_key}" GRAPHQL_ENDPOINT = "{your_graphql_endpoint}"

Integration with MCP Clients (e.g., Claude Desktop)

To enable clients like Claude Desktop to utilize this policy service, append the following configuration snippet to the relevant client settings file (e.g., ~/Library/Application Support/Claude/claude_desktop_config.json):

"shipping-policies": {
  "command": "uv",
  "args": [
    "--directory",
    "{path_to_mcp_server}/mcp-server-trueRAG",
    "run",
    "fastmcp",
    "run",
    "server.py"
  ]
}