项目简介

这是一个基于 Model Context Protocol (MCP) 实现的服务器,专为结合 Intel Graphics Control Library (IGCL) 进行概念验证 (PoC) 而设计。它使得AI助手(如Claude)可以通过标准化的MCP协议与英特尔图形硬件进行交互,从而控制图形设置。

主要功能点

  • 模块化插件支持: 服务器核心采用插件架构,可轻松扩展功能。
  • 轻量级通信: 使用轻量级的JSON-RPC协议通过标准I/O (Stdio) 进行通信。
  • 图形设置控制: 通过插件调用IGCL,实现对各种英特尔图形设置的读取和控制。
  • AI助手集成: 可与支持MCP协议的AI助手无缝集成,让AI能够调用图形控制功能。

安装步骤

  1. 环境准备: 确保系统安装了 CMake (3.20+) 和支持 C++20 的编译器 (Windows推荐使用 MinGW64)。
  2. 克隆仓库:
    git clone https://github.com/paulchi-intel/mcp-server-igcl-poc.git
    cd mcp-server-igcl-poc
  3. 准备IGCL库: 获取 Intel Graphics Control Library (IGCL) 包,并将其放置在例如 'C:\ControlApi' 的目录。
  4. (仅Windows/MinGW)构建IGCL的.lib文件: 在 MinGW 64-bit 终端中,进入IGCL的DLL目录(如 'C:\ControlApi\Release\Dll'),执行 'gendef' 和 'dlltool' 命令为所需的DLL文件生成 .def 和 .lib 文件。
    # 在 MinGW 64-bit 終端機中執行
    cd /c/ControlApi/Release/Dll
    gendef IntelControlLib.dll
    dlltool -d IntelControlLib.def -l IntelControlLib.lib -D IntelControlLib.dll
    gendef ControlLib.dll
    dlltool -d ControlLib.def -l ControlLib.lib -D ControlLib.dll
    # 如果需要32位库,也执行相应命令
    # gendef IntelControlLib32.dll
    # dlltool -d IntelControlLib32.def -l IntelControlLib32.lib -D IntelControlLib32.dll
    # gendef ControlLib32.dll
    # dlltool -d ControlLib32.def -l ControlLib32.lib -D ControlLib32.dll
  5. 构建服务器:
    mkdir build && cd build
    cmake .. -G "MinGW Makefiles" # 根据您的系统和编译器调整 -G 参数
    cmake --build . # 或 mingw32-make (for MinGW) 或 make (for Linux/macOS)
  6. 部署文件:
    • 创建目标文件夹,例如 'C:\mcp_server_igcl'。并在其中创建 'plugins' 和 'logs' 子文件夹。
    • 将构建好的服务器执行文件(例如 'build/server_igcl_poc.exe')复制到 'C:\mcp_server_igcl'。
    • 将构建好的所有插件文件(例如 'build/plugins/*.dll')复制到 'C:\mcp_server_igcl\plugins'。

服务器配置(用于MCP客户端)

MCP客户端(如支持MCP的AI助手应用)需要配置服务器的启动方式。通常是在客户端的配置文件中指定服务器执行文件的路径和参数。以下是一个示例配置结构及其参数说明(具体配置格式取决于您的MCP客户端):

{
  "mcpServers": {
    "服务器名称": { // 例如 "server_igcl_poc"
      "command": "服务器执行文件路径", // 例如 "C:\\mcp_server_igcl\\server_igcl_poc.exe"
      "args": [ // 启动参数列表
        "-n", "服务器名称", // 可选,服务器的名称
        "-l", "日志目录路径", // 日志文件存放的目录,例如 "C:\\mcp_server_igcl\\logs"
        "-p", "插件目录路径"  // 插件文件存放的目录,例如 "C:\\mcp_server_igcl\\plugins"
      ],
      // 其他可能的配置,如 "env" (环境变量) 等
    }
  }
}

请根据您实际的安装路径修改上述 'command' 和 'args' 中的路径信息,并将其添加到MCP客户端的配置文件中。

基本使用方法

配置完成后,启动您的MCP客户端。客户端会自动检测并启动配置好的MCP服务器。服务器会加载指定插件目录中的所有插件,并将其提供的工具、资源和提示暴露给客户端。

您现在可以通过AI助手的界面或交互方式来调用服务器提供的功能,例如:

  • 询问有关3D图形能力的信息(调用 'get_3d_capabilities' 工具)。
  • 要求AI助手设置各向异性过滤(调用 'set_anisotropic' 工具)。
  • 要求AI助手启用或禁用耐久游戏模式(调用 'set_endurance_gaming_mode' 工具)。
  • 要求AI助手调整帧同步设置(调用 'set_frame_sync' 工具)。

具体如何通过AI助手触发这些调用,取决于AI助手的交互设计。

演示视频

观看示範影片可以更直观地了解安装和与Claude Desktop集成的完整流程。

信息

分类

桌面与硬件