Risify MCP Public

risify mcp

Risify GraphQL API的模型上下文协议（MCP）服务器。帮助AI助手搜索模式并编写正确的GraphQL查询和突变。

安装

macOS/Linux

curl -sL https://raw.githubusercontent.com/analyzify/risify-mcp-public/main/install.sh | sh

此功能会自动检测您的操作系统和体系结构，下载最新的二进制文件，并将其安装到 /usr/local/bin.

Windows（PowerShell）

irm https://raw.githubusercontent.com/analyzify/risify-mcp-public/main/install.ps1 | iex

这将下载最新的Windows二进制文件并将其安装到 %LOCALAPPDATA%\risify-mcp，自动将其添加到PATH中。

支持的平台： macOS（英特尔/苹果硅）、Linux（amd64/arm64）、Windows（amd64/2arm64）

手动安装

从以下网址下载适用于您平台的二进制文件 发布 页面，提取它，并将其放置在您的 $PATH.

验证

risify-mcp version

在Windows上，您还可以使用： risify-mcp.exe version

配置

添加到MCP客户端配置中：

克劳德代码 (.claude/settings.json):

{
  "mcpServers": {
    "risify": {
      "command": "risify-mcp",
      "args": ["serve"],
      "env": {
        "RISIFY_USER_ID": "your-user-id",
        "RISIFY_API_KEY": "your-api-key"
      }
    }
  }
}

克劳德桌面 (claude_desktop_config.json):

{
  "mcpServers": {
    "risify": {
      "command": "risify-mcp",
      "args": ["serve"],
      "env": {
        "RISIFY_USER_ID": "your-user-id",
        "RISIFY_API_KEY": "your-api-key"
      }
    }
  }
}

光标/VS代码 （MCP设置）：

{
  "risify": {
    "command": "risify-mcp",
    "args": ["serve"],
    "env": {
      "RISIFY_USER_ID": "your-user-id",
      "RISIFY_API_KEY": "your-api-key"
    }
  }
}

如果没有env变量，服务器将以仅模式工作（搜索+完整模式工具）。

环境变量

测试

安装后，验证一切正常：

1.公共路由（无需身份验证）

risify-mcp query '{ ping }'

预期：

{
  "data": {
    "ping": "pong"
  }
}

2.经过身份验证的路由

设置您的凭据并测试 me 查询：

RISIFY_USER_ID="your-user-id" \
RISIFY_API_KEY="your-api-key" \
  risify-mcp query '{ me { id email firstName lastName shopName } }'

预期（具有有效凭据）：

{
  "data": {
    "me": {
      "id": "...",
      "email": "...",
      "firstName": "...",
      "lastName": "...",
      "shopName": "..."
    }
  }
}

3.模式搜索（离线）

risify-mcp search audit
risify-mcp search product --filter queries
risify-mcp search recommendation --filter mutations

CLI命令

risify-mcp serve                                    # Start MCP server (stdio)
risify-mcp serve --transport sse --addr :8080       # Start MCP server (SSE HTTP)
risify-mcp search audit                             # Search schema for "audit"
risify-mcp search product --filter queries          # Search queries only
risify-mcp query '{ ping }'                         # Execute a query
risify-mcp version                                  # Print version

MCP工具

卸载

macOS/Linux

sudo rm /usr/local/bin/risify-mcp

Windows（PowerShell）

Remove-Item "$env:LOCALAPPDATA\risify-mcp" -Recurse -Force

删除后，您可能还想删除 %LOCALAPPDATA%\risify-mcp 通过系统设置从PATH环境变量中。