从 Stdio 到 HTTP SSE，在 APIPark 托管 MCP Server

news2025/6/7 14:23:32

MCP（Model Context Protocol，模型上下文协议）是一种由 Anthropic 公司于 2024 年 11 月推出的开源通信协议，旨在标准化大型语言模型（LLM）与外部数据源和工具之间的交互。

它通过定义统一的接口和通信规则，解决 AI 模型因数据孤岛而无法充分利用外部信息的难题，从而提升模型生成响应的准确性、相关性和实用性。

作为一项新兴的开放协议，MCP 为 LLM 与外部应用之间构建了双向通信通道，就像是 AI 的“USB-C”接口，帮助模型发现、理解并安全调用各种外部工具或 API。

这意味着：

1）开发者不再需要为对接每一个外部服务而编写复杂的定制接口。

2）用户可以体验到 AI 轻松调用海量第三方应用的能力，无论是处理日常办公任务、分析数据，还是执行营销自动化，AI 正从“智能对话”迈向“高效行动”。

MCP

MCP 的两种通信模式

MCP 定义了两种主要的通信模式，用于支持本地和远程场景下的数据交互。

本地通信模式（Stdio 模式）： 客户端启动服务器程序作为子进程，消息通过标准输入/输出（stdin/stdout）进行数据传输，适用于本地环境下的客户端与服务器通信。这种模式高效、低延迟，适合单机环境，安全性高，无需网络传输，但该模式仅限于本地通信，无法跨设备或远程访问。

远程通信模式（HTTP + SSE 模式）：
通过基于 HTTP 的服务器发送事件（Server-Sent Events, SSE）进行通信，适用于客户端与服务器部署在不同设备或远程环境的情况。该模式灵活性高，支持跨设备和远程交互。适合实时性要求高的场景，如动态数据查询。

MCP 的两种通信模式

APIPark 一键配置 MCP Server

APIPark 提供高效解决方案，将 API 快速转为 MCP（Model Context Protocol）Server，简化大型语言模型（LLM）与外部数据源的集成。

相较传统 Stdio 模式仅限本地的局限，APIPark 通过 HTTP + SSE 模式支持跨设备访问，无需本地环境即可调用，提升灵活性和可访问性。

开发者可轻松将 API 功能暴露给 AI 模型，实现高效的上下文交互和工具调用。

APIPark 支持两种 MCP Server 类型，满足不同场景需求：

系统级别 MCP Server：

功能： 统一访问平台所有公开服务，简化多服务集成。
适用场景： 构建多模态 AI 智能体或自动化工作流，如集成 CRM、ERP 和第三方 API。优势： 降低开发成本，支持动态扩展，适合复杂协作场景。

服务级别 MCP Server：

功能： 以单一服务为单位托管 API，提供细粒度权限控制。
适用场景： 敏感数据安全集成（如财务 API）、定制化 AI 应用或多租户系统。
优势： 高安全性，支持服务定制和隔离。

〇前期准备

接下来我们将以获取天气信息为例，演示如何配置 MCP Server。

操作前需准备 ：

1）升级 APIPark ：安装或升级 APIPark 至 v1.7.2-beta 或更高版本，以支持最新的 MCP Server 功能和优化。

2）准备 API 服务：确保您有一个可调用的 API 服务（如 RESTful ），且服务正常运行。

3）OpenAPI 文档：准备规范的 OpenAPI（JSON/YAML）文档，包含端点、参数和认证信息。

4）准备 MCP 客户端：准备一个 MCP 客户端工具或应用程序（如：Cline、Dify、Cursor、Claude等），用于测试和验证 MCP Server 的功能和响应，确保服务正常运行。

注意：确保 API 文档格式规范（如 JSON 或 YAML），以提高 APIPark 的解析效率。

示例 OpenAPI 文档如下：

  info:
  description: 基于APISpace提供的环境天气接口，支持实时天气查询和15天内的天气预报查询
  license:
    name: Eolink
    url: https://www.eolink.com
  title: 环境天气查询-V1.0
  version: "1.0"
openapi: 3.0.3
paths:
  /456456/function/v001/city:
    get:
      summary: 城市ID和经纬度搜索（支持全球城市）
      tags:
        - 默认分组
      ...
  /456456/weather/v001/day:
    get:
      summary: 天气预报
      tags:
        - 默认分组
      ...
  /456456/weather/v001/now:
    get:
      summary: 智能天气实况
      tags:
        - 默认分组
      ...
tags:
  - name: 默认分组

〇开始配置