平台开发与集成指南
概览
Model Context Protocol(MCP)是 Anthropic 主导的 AI 工具连接开放标准, 让 AI 模型能够安全地调用外部工具、读取外部数据、执行外部操作。
类比:USB-C 让硬件设备即插即用,MCP 让 AI 工具即插即用。
在 Agent 编排页面 → 工具 → 添加 MCP Server,选择预置项,填入凭据即可。
# 以 GitHub MCP Server 为例
# 1. 在 GitHub 创建 Personal Access Token
# Settings → Developer settings → PAT (classic) → 勾选 repo, read:org
# 2. 在智汇 AI 后台填入
Server: GitHub MCP
Token: ghp_xxxxxxxxxxxx
# 3. Agent 自动获得能力:
# - 搜索代码 / 读取文件 / 创建 PR
# - 列出 Issue / 创建 Issue / 评论
# - 查看仓库统计 / 提交历史
# 4. 在对话中直接调用
用户: "帮我看一下 facebook/react 最近的 Issue 有哪些是 bug"
Agent: [调用 GitHub MCP] 找到 23 个 bug 标签的 Issue...企业内部系统(ERP/OA/CRM)可封装为 MCP Server,让 Agent 安全调用。
# TypeScript SDK
npm create mcp-server@latest my-server
# Python SDK
pip install mcp
mcp create my-server示例:查询订单的 MCP Server(TypeScript)
import { McpServer } from '@modelcontextprotocol/sdk'
import { z } from 'zod'
const server = new McpServer({ name: 'order-query', version: '1.0.0' })
server.tool(
'get_order',
{ orderId: z.string() },
async ({ orderId }) => {
const order = await db.orders.findById(orderId)
return {
content: [
{ type: 'text', text: JSON.stringify(order, null, 2) }
]
}
}
)
server.tool(
'list_orders',
{ status: z.enum(['pending', 'paid', 'shipped']).optional() },
async ({ status }) => {
const orders = await db.orders.findMany({ where: { status } })
return { content: [{ type: 'text', text: JSON.stringify(orders) }] }
}
)
await server.connect()部署方式