fore-vip MCP Server 使用指南

最后更新: 2026-03-23
版本: v0.0.6
项目: 前凌智选 (fore.vip)

📖 目录

  1. 简介
  2. 快速开始
  3. 认证机制
  4. API 参考
  5. 使用示例

简介

fore-vip MCP Server 是前凌智选平台提供的 AI Agents 技能服务，基于 Model Context Protocol (MCP) 标准协议构建。

核心功能:

  • 🎯 创建线下活动/会议
  • 📦 查询 AI 产品目录
  • 🚀 发布 AI 产品/机器人

API 端点: https://api.fore.vip

快速开始

第一步：获取 OpenKey

  1. 访问 https://fore.vip
  2. 登录账号
  3. 进入 个人中心 (ucenter)
  4. 找到 OpenKey 模块
  5. 点击 “生成 Open Key”
  6. 复制生成的 Key

第二步：调用 API

1
2
3
4
5
6
7
8
curl -X POST https://api.fore.vip/mcp/create_activity \
  -H "Authorization: Bearer YOUR_OPEN_KEY" \
  -d '{
    "content": "AI 技术分享会",
    "start_time": 1711094400000,
    "address": "北京市朝阳区",
    "wx": "forevip123"
  }'

认证机制

认证方式（任选其一）

方式 1: Authorization Header（推荐）

1
-H "Authorization: Bearer YOUR_OPEN_KEY"

方式 2: X-Open-Key Header

1
-H "X-Open-Key: YOUR_OPEN_KEY"

认证规则

API 端点 是否需要认证
POST /mcp/create_activity ✅ 需要
POST /mcp/create_kl ✅ 需要
POST /mcp/query_kl ❌ 不需要
GET /tools/list ❌ 不需要

API 参考

1. 创建活动 (create_activity)

端点: POST /mcp/create_activity
认证: ✅ 需要

必需参数:

  • content (string): 活动介绍（≥2 字符）
  • start_time (number): 开始时间戳（毫秒）
  • address (string): 活动地址
  • wx (string): 联系微信

响应示例:

1
2
3
4
5
{
  "success": true,
  "id": "69c0...",
  "url": "https://fore.vip/st?id=69c0..."
}

2. 查询产品 (query_kl)

端点: POST /mcp/query_kl
认证: ❌ 不需要

参数:

  • tag (string): 产品标签（如”推荐”）
  • limit (number): 最大结果数 (1-100)
  • skip (number): 分页跳过数

3. 发布产品 (create_kl)

端点: POST /mcp/create_kl
认证: ✅ 需要

必需参数:

  • name (string): 产品名称（≥2 字符）
  • content (string): 产品描述（≥10 字符）

使用示例

JavaScript 示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
const response = await fetch('https://api.fore.vip/mcp/create_activity', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_OPEN_KEY'
  },
  body: JSON.stringify({
    content: 'AI 技术分享会',
    start_time: Date.now() + 86400000,
    address: '北京市朝阳区',
    wx: 'forevip123'
  })
});

const result = await response.json();
console.log(result);

Python 示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
import requests

response = requests.post(
    'https://api.fore.vip/mcp/create_activity',
    headers={
        'Authorization': 'Bearer YOUR_OPEN_KEY'
    },
    json={
        'content': 'AI 技术分享会',
        'start_time': int(time.time() * 1000) + 86400000,
        'address': '北京市朝阳区',
        'wx': 'forevip123'
    }
)

print(response.json())

常见问题

Q1: 如何获取 OpenKey？

访问 https://fore.vip → 登录 → 个人中心 → 生成 Open Key

Q2: 为什么提示 “Missing Open Key”？

需要在 Header 中添加认证：

1
-H "Authorization: Bearer YOUR_OPEN_KEY"

Q3: 查询产品需要认证吗？

不需要，query_kl 接口无需认证。

文档版本: v0.0.6
最后更新: 2026-03-23