Ad Veritas MCP Server Truerag

🚀 模型上下文協議（MCP）服務器用於GraphQL策略API

本項目的模型上下文協議（MCP）服務器，為GraphQL API提供了訪問策略的功能。它能幫助開發者更便捷地與GraphQL API進行交互，有效管理訪問策略，提升開發效率。

🚀 快速開始

克隆倉庫

首先，你需要將項目倉庫克隆到本地，並進入項目目錄。執行以下命令：

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

確保已安裝uv

使用以下命令檢查uv是否已安裝：

uv --version

若未安裝，可根據不同的操作系統選擇相應的安裝命令：

# 適用於macOS和Linux。
curl -LsSf https://astral.sh/uv/install.sh | sh

# 適用於Windows。
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

定義環境變量

本服務器配置為與TrueRag系統之一的GraphQL API一起使用。在創建TrueRAG環境後，需將API密鑰和端點複製到環境變量中。 在倉庫根目錄下創建一個名為.env的文件，並添加以下內容：

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

添加到MCP客戶端，例如Claude Desktop

將以下內容添加到Claude配置文件（~/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"
      ]
    }

📦 安裝指南

此項目的安裝主要涉及克隆倉庫、安裝uv工具以及配置環境變量，詳細步驟如下：

1. 克隆倉庫：使用git clone命令將項目克隆到本地。
2. 安裝uv：根據不同的操作系統，使用相應的命令安裝uv。
3. 配置環境變量：在項目根目錄下創建.env文件，並添加GraphQL API的密鑰和端點。
4. 配置MCP客戶端：將特定內容添加到Claude的配置文件中。

🔧 技術細節

此MCP服務器使用python SDK for MCP構建，藉助該SDK可以方便地與MCP進行交互。同時，利用GQL庫與GraphQL API進行通信，實現訪問策略的功能。服務器的配置與TrueRag系統的GraphQL API緊密結合，通過環境變量的設置來確保與特定的API進行交互。