文档中心

Appearance

概述 ​

MCP（Model Context Protocol）是新一代AI应用集成协议，基于标准 JSON-RPC 2.0 格式，实现AI平台与云端服务之间的无缝连接。通过MCP协议，大模型可以动态发现和调用外部"工具"（Tool），极大扩展AI应用的能力边界。

MCP协议优势 ​

  • 🔌 标准化接口：基于JSON-RPC 2.0，确保跨平台兼容性
  • 🚀 动态发现：支持工具的动态注册和发现机制
  • 🔒 安全可靠：内置身份验证和权限控制
  • 📈 高性能：轻量级协议设计，支持高并发调用
  • 🛠️ 易于扩展：模块化架构，便于添加新功能

本指南将详细介绍如何搭建云端MCP服务器，实现与灵矽AI平台的深度集成，让您的AI助手具备丰富的外部能力。

目录 ​

典型使用场景 ​

云端MCP服务为AI应用提供了强大的外部能力扩展，主要应用于以下场景：

架构图 ​

┌─────────────────┐     MCP协议      ┌─────────────────┐     API调用     ┌─────────────────┐
│   灵矽AI平台    │ ←──────────→    │   云端MCP服务   │ ←──────────→   │   第三方服务    │
│  (智能助手)     │   JSON-RPC 2.0   │  (Go+ 服务器)   │    HTTP/gRPC    │   (外部API)     │
└─────────────────┘                  └─────────────────┘                 └─────────────────┘
         │                                    │                                    │
    用户交互指令                          工具调用转发                        实际业务处理
         │                                    │                                    │
         ├── "播放音乐"                      ├── 🎵 音乐播放控制                  ├── Spotify API
         ├── "查询天气"                      ├── 🌤️ 天气信息查询                  ├── OpenWeather API
         ├── "安排会议"                      ├── 📅 日程管理                      ├── Google Calendar
         ├── "控制灯光"                      ├── 📱 智能家居控制                  ├── 小米/华为IoT
         ├── "获取新闻"                      ├── 📰 新闻资讯                      ├── 新闻API
         └── "搜索信息"                      └── 🔍 信息检索                      └── 搜索引擎API

核心应用场景 ​

🎵 音乐娱乐服务 ​

  • 音乐播放控制：播放、暂停、切换歌曲、调节音量
  • 歌单管理：创建播放列表、收藏歌曲、推荐音乐
  • 多平台支持：Spotify、网易云音乐、QQ音乐等

🌤️ 生活信息服务 ​

  • 天气查询：实时天气、7天预报、空气质量指数
  • 出行建议：交通状况、路线规划、公交查询
  • 生活指数：紫外线、穿衣、运动指数

📅 效率办公服务 ​

  • 日程管理：查看安排、添加提醒、会议通知
  • 任务管理：待办事项、项目跟踪、进度提醒
  • 文档处理：文件搜索、格式转换、内容摘要

📱 智能家居控制 ​

  • 设备控制：灯光、空调、窗帘、音响等
  • 场景模式：回家模式、睡眠模式、离家模式
  • 安全监控：门锁状态、摄像头查看、报警通知

📰 信息获取服务 ​

  • 新闻资讯：热点新闻、行业动态、个性化推荐
  • 金融信息：股票行情、汇率查询、投资建议
  • 知识问答：百科查询、翻译服务、计算工具

业务价值 ​

  • 🚀 快速集成：标准化协议，降低接入成本
  • 🔄 灵活扩展：模块化设计，易于添加新功能
  • ⚡ 高效响应：异步处理，提升用户体验
  • 🛡️ 安全可控：权限管理，保障数据安全

环境要求 ​

系统要求 ​

  • 操作系统：Linux、macOS、Windows
  • Go+ 版本：>= 1.2.0
  • 内存：最低 512MB，推荐 2GB+
  • 存储：最低 1GB 可用空间
  • 网络：支持 HTTPS 和 WebSocket 连接

开发环境 ​

bash
# 安装 Go+
curl -sSL https://goplus.org/install.sh | sh

# 验证安装
gop version

# 配置环境变量
export GOPLUS_ROOT=/usr/local/goplus
export PATH=$GOPLUS_ROOT/bin:$PATH

依赖服务 ​

  • 数据库：MySQL 8.0+ / PostgreSQL 12+ / Redis 6.0+（可选）
  • 消息队列：RabbitMQ / Apache Kafka（可选）
  • 监控工具：Prometheus + Grafana（推荐）

快速开始 ​

1. 创建基础MCP服务 ​

bash
# 创建项目目录
mkdir my-personal-assistant
cd my-personal-assistant

# 初始化Go+项目
gop mod init my-personal-assistant

# 添加MCP依赖
gop get github.com/goplus/mcp@latest

2. 创建基础MCP服务器 ​

go
// main_mcp.gox
server "个人助手MCP服务 🤖", "1.0.0"
go
// weather_tool.gox
tool "weather.get", => {
	description "获取指定城市的天气信息"
	string "city", => {
		required
		description "城市名称，如：北京、上海、深圳"
	}
}

city, ok := ${city}.(string)
if !ok {
	return newError("城市名称必须是字符串")
}

// 模拟天气API调用
weatherInfo := getWeatherInfo(city)
return text("📍 ${city}\n🌤️ 天气：${weatherInfo.condition}\n🌡️ 温度：${weatherInfo.temperature}°C\n💨 风力：${weatherInfo.wind}")

3. 运行和测试服务 ​

bash
# 整理依赖
gop mod tidy

# 运行MCP服务
gop run .

4. 在灵矽AI平台注册服务 ​

在灵矽AI平台的MCP服务管理页面，添加您的服务端点：

  • 服务名称：个人助手MCP服务
  • SSE URL：https://your-domain.com/mcp
  • 描述：提供天气查询、音乐播放等个人助手功能