MCP Server
MCP 是什么？
核心概念
随着 Agent 应用的迅速发展，开发者在工具的开发与集成过程中逐渐暴露出一些共性难题：缺少统一标准导致效率受限；不同平台间需要反复适配，增加了人力与时间成本；社区开源工具参差不齐，高质量能力的维护和整合往往代价高昂。
MCP（Model Context Protocol） 正是在这样的背景下被提出。它由 Anthropic 发布，是当前业界领先的开放协议，目标是在大模型与外部数据源之间建立安全且一致的双向连接，从而解决工具实现方式碎片化、难以跨模型共享等问题。
MCP 就像是一个“通用插头"或者“USB 接口”，MCP协议制定了统一的规范，规定了应用向LLM传输数据的方式。 任何模型只要兼容MCP协议，就能与所有支持MCP的应用交互 。
通过智能管家故事理解Agent / MCP / API（Tool）
想象你家里有一位 智能管家，你只需要提出需求，他就能帮你安排好一切事务。这就是 Agent（智能体） 的角色。
| 角色 | 在故事里的比喻 | 在技术里的对应 | 主要职责 |
|---|---|---|---|
| 👤 用户 | 主人 | 最终用户 | 提出需求，等待结果 |
| 🤖 Agent | 智能管家 | 智能体 | 理解需求，做推理，调度工具。 • 职责：理解用户需求，决定执行内容与顺序。 • 能力：将多个任务串联成完整方案。 • 类比：大脑与决策中心。 |
| 🔌 MCP | 插座标准（Type-C） | 协议层 | 聪明的管家再厉害，如果每个工具调用方式都不一样，他也会很头疼。 换句话说，MCP 解决了“工具调用标准化”的问题，让管家专注安排任务，而非适配接口。 • 统一工具调用规范 • 管家无需关心工具内部实现 • 标准化后即插即用 |
| 🛠️ Tool | 各种工具（天气 / 机票 / 邮件） | API 或服务 | 工具才是真正干活的角色： • 天气工具 → 返回天气情况 • 机票工具 → 提供航班信息 • 邮件工具 → 发送确认邮件 |
API 文档 → Function Call → MCP三种开发方式的演进对比
“人类理解” → “模型理解（半自动）” → “模型直接执行（协议化）”
| 维度 | API 文档开发 | Function Call 开发 | MCP 开发 |
|---|---|---|---|
| 🧠 理解主体 | 人类开发者 | 模型 + 人类（手动注册工具） | 模型（自动理解协议） |
| 🎯 目标对象 | 给人看的文档 | 给模型看的函数签名 | 给模型的机器可读协议描述 |
| 🚀 使用方式 | 人类读文档 → 写请求 → 调用 | 手动定义函数描述（schema） → 模型根据描述调用 | MCP 服务自动暴露能力 → 模型直接发现并调用 |
| 🧩 工具配置 | 每个平台都要单独封装 | 每个平台都要注册工具函数 | 配置一次 MCP 服务地址即可 |
| 🔍 可发现性 | 查阅文档 | 人工注册 | 模型自动发现（动态能力发现） |
| 🔄 工具更新 | 文档更新需人工同步 | 每个平台都需维护更新 | MCP 自动同步能力清单（manifest） |
| 🧰 适配复杂度 | 高：需人工封装 / prompt 调整 | 中：需定义 function schema | 低：协议自动暴露能力，无需重复配置 |
| 🧠 模型理解 | 需阅读说明（Prompt 驱动） | 依赖函数说明推理使用方法 | 结构化、协议内置类型 → 模型直接理解 |
| 🔒 调用安全性 | 弱（参数拼错易失败） | 较强（schema 限制参数格式） | 最强（协议层验证 + 上下文控制） |
| 💬 比喻 | “看说明书自己动手” | “看函数签名，照着调用” | “插上 Type-C，自动识别并工作” |
| ⚙️ 技术抽象层 | 应用层 | SDK 层 | 协议层 |
| 🌐 扩展性 | 低：各自封装 | 中：依赖平台支持 | 高：跨平台统一能力发现 |
| 👩💻 开发者体验 | 以人为中心：需要编写和维护文档 | 半自动化：仍需注册与封装 | 全自动化：一次集成，多模型复用 |
如何使用
APIfox MCP 和 HAP MCP 的使用场景:
-
通过 APIfox的 MCP 获取最新的 HAP 应用接口文档，可用于“让模型读文档、懂接口”
-
通过 HAP 的 MCP 能直接操作应用数据，用于“让模型执行业务、调系统”
| APIfox MCP | HAP MCP | |
|---|---|---|
| 作用 | 让模型“读懂HAP 的接口文档”。 | 让模型“执行HAP 应用接口”。 |
| 功能入口 | 文档地址：https://apifox.nocoly.com  | 在应用API开发文档中 查看。  |
| 使用场景 | 需要理解可用的 HAP API 结构，用于生成调用 方案或实现业务编排。 📍示例：有个客户案例管理应用，想基于应用数据做个可视化页面。可以在客户端（如 cursor）通过APIfox MCP 读取 HAP 接口文档（推荐使用 V3 接口），页面上实现对应用数据的实时展示。 | 直接执行业务动作或访问真实数据。 📍示例：在编排场景中，需要直接获取应用数据和结构，进行分析、字段映射或直接修改应用数据。 |
| 特点 | 暴露的是接口定义、文档、示例（只读信息）帮助模型成为“懂接口的研发助手”适合项目开发、文档自动化、API 发现 | 暴露的是可执行工具（带权限与安全控制）帮助模型成为“能办事的智能管家”适合生产执行、业务治理、系统编排 |
MCP 配置
获取 HAP MCP 配置
-
应用 API 文档-MCP，获取 url 用于下方配置
Cursor
-
打开Cursor-首选项-Cursor Settings-MCP，Add new globle MCP server
-
保存后返回，绿色代表连接正常
Dify
Agent 应用中使用 MCP
-
点击右上角插件，探索 Marketplace ，搜索 MCP，找到 【MCP SSE / StreamableHTTP】，点击安装
-
已安装插件中，找到 【MCP SSE / StreamableHTTP】
-
示例配置： 填入 MCP 配置，其中"hap-mcp" 可替换为任意名称，url 需填入应用中生成的 url
{"hap-mcp":{"transport":"streamable_http","url":"填入应用中生成的url"}}
-
添加 MCP 工具，测试效果
workflow 中使用 MCP
-
点击右上角插件，探索 Marketplace ，搜索 【Agent 策略（支持 MCP 工具）】 ，点击安装
-
**示例配置：**填入 MCP 配置，其中"hap-mcp" 可替换为任意名称，url 需填入应用中生成的 url
{"hap-mcp":{"transport":"streamable_http","url":"填入应 用中生成的url"}}
VS Code + Cline 插件
-
安装Cline插件
-
右下方点击 MCP Servers，完成配置
-
示例配置：
"hap-mcp": {"url": "填入应用中生成的url","type": "streamableHttp","disabled":false,"autoApprove": []}