🚀 模型上下文协议（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进行交互。