MCP Server 集成指南 NEW

什么是 MCP

Model Context Protocol (MCP) 是 Anthropic 提出的开放协议标准，让 AI 模型可以安全、标准化地访问外部工具和数据源。

风控云 MCP Server 实现了该协议，让 Claude、GPT 等 AI 助手可以直接调用风控决策引擎，执行以下操作：

• 对交易进行实时风控决策，获取通过/拒绝/复核结果
• 查询黑名单，检查手机号、身份证、IP 是否异常
• 获取风控统计数据，了解通过率、拒绝率、趋势变化
• 查看已配置的风控产品列表

技术架构

MCP Server 作为 AI Agent 与风控后端之间的桥梁，通过 stdio 传输协议与 AI 工具通信，通过 HTTP API 调用风控后端服务。

  Claude Desktop / Cursor / Claude Code
              |
              |  MCP Protocol (stdio)
              v
      +-----------------+
      |  MCP Server     |
      |  (Node.js)      |
      +-----------------+
              |
              |  HTTP API
              v
      +-----------------+
      |  风控云后端      |
      |  (Java/Spring)  |
      +-----------------+
         |           |
    /trade/invoke   /api/v1/risk/decide
    (公开 API)      (OpenClaw API Key)

快速开始

三步完成 MCP Server 的安装和配置：

安装与编译

# 进入 MCP Server 目录
cd mcp-server

# 安装依赖
npm install

# 编译 TypeScript
npm run build

# 测试运行（按 Ctrl+C 退出）
npm start

可用工具 (Tools)

MCP Server 提供以下三个工具，AI Agent 可以在对话中自动调用：

可用资源 (Resources)

Claude Desktop 集成

Claude Desktop 原生支持 MCP 协议。编辑配置文件即可接入风控云 MCP Server。

配置文件路径

配置内容

{
  "mcpServers": {
    "fengkong": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "RISK_API_URL": "https://app.fengkong.cloud",
        "RISK_API_KEY": "your-api-key-here"
      }
    }
  }
}

将 /path/to/mcp-server 替换为 MCP Server 的实际安装路径。API Key 可在风控云控制台的「API 管理」中获取。

Cursor 集成

Cursor 编辑器支持通过 MCP 协议扩展 AI 能力。在项目根目录创建配置文件即可。

{
  "mcpServers": {
    "fengkong": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "RISK_API_URL": "https://app.fengkong.cloud",
        "RISK_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code (CLI) 集成

Claude Code 命令行工具支持通过 claude mcp add 命令添加 MCP Server。

claude mcp add fengkong node /path/to/mcp-server/dist/index.js \
  --env RISK_API_URL=https://app.fengkong.cloud \
  --env RISK_API_KEY=your-api-key-here

添加后，在 Claude Code 对话中即可直接使用风控工具。

使用示例

配置完成后，在 AI 对话中可以用自然语言调用风控 API：

风控决策

黑名单查询

统计查询

环境变量配置

获取 API Key：登录 风控云控制台 → API 管理 → 创建 API Key。

常见问题