GFast开发MCP服务器之mark3labs/mcp-go库接入(二)

接下来我们正式把mark3labs/mcp-go接入到GFast框架,并实现自动注册,后续我们只需要添加对应的toolresourceprompt方法即可

一、首先要了解toolresourceprompt是什么,有什么作用。

Model Context Protocol (MCP) 框架中,Tool、Resource、Prompt 是三个核心组件,分别承担不同的角色,共同协作以优化模型对上下文的理解和处理能力。以下是它们的详细解释和作用:


1. Tool(工具)

定义

  • Tool 是模型可调用的外部功能模块或接口,用于扩展模型的基础能力(如计算、搜索、代码执行等)。
  • 在 MCP 中,Tools 通常以标准化协议(如 OpenAI 的 Function Calling)集成,允许模型动态选择并执行工具。

作用

  • 增强模型功能 :弥补纯语言模型的局限性(如实时数据获取、数学运算)。
    示例:调用搜索引擎 API 获取最新新闻,或使用 Python 解释器运行代码。
  • 自动化任务:将复杂任务分解为工具链(如先检索知识库,再生成摘要)。
  • 上下文动态更新:通过工具返回的结果,实时更新模型的上下文。

典型场景

  • 查询天气、股票等实时信息。
  • 执行数据库操作或数据分析。

2. Resource(资源)

定义

  • Resource 是模型可访问的静态或动态数据源,包括知识库、数据库、文档集合等。
  • 在 MCP 中,Resources 通过索引或向量化技术(如 RAG)被高效检索和加载到上下文中。

作用

  • 扩展知识边界:为模型提供训练数据之外的领域知识(如企业私有文档)。
  • 支持长上下文 :通过按需加载资源片段,避免一次性输入全部内容。
    示例:仅加载与用户问题相关的文档段落,而非整个 PDF。
  • 多模态支持:资源可以是文本、表格、图像(需编码为模型可理解的格式)。

典型场景

  • 法律顾问模型引用法典条款。
  • 医疗诊断模型参考最新医学论文。

3. Prompt(提示)

定义

  • Prompt 是用户或系统提供给模型的指令或上下文输入,用于引导模型行为。
  • 在 MCP 中,Prompt 可能被结构化设计(如包含角色设定、任务步骤、示例等)。

作用

  • 控制模型输出 :通过精心设计的 Prompt 约束生成内容(如格式、风格)。
    示例

    arduino 复制代码
    "你是一名资深翻译官,将以下中文翻译成英文,要求使用学术用语:{text}"
  • 动态上下文管理 :Prompt 可包含对 Tool 或 Resource 的引用。
    示例

    复制代码
    "根据从{数据库工具}检索到的2023年财报,总结公司的营收趋势。"
  • 多轮对话维护:在对话系统中,Prompt 可能隐式包含历史对话的压缩摘要。

典型场景

  • 复杂任务分解(如分步骤生成报告)。
  • 个性化交互(如设定模型角色为"幽默的助手")。

三者的协同关系

  1. 用户输入 Prompt → 模型解析后,发现需要调用 Tool (如搜索)→ Tool 返回结果作为 Resource → 模型整合资源生成最终回复。
  2. Prompt 中嵌入 Resource 引用 → 模型通过检索工具加载相关资源 → 结合资源内容生成答案。

示例流程

arduino 复制代码
用户 Prompt: "特斯拉2023年Q3的营收是多少?"  
→ 模型调用 "财经数据查询 Tool"  
→ Tool 访问财务报表 Resource(如数据库)  
→ 返回数据后,模型生成回答: "特斯拉2023年Q3营收为234亿美元。"  

总结对比

组件 核心作用 关键特点
Tool 扩展模型能力,执行外部操作 动态性、API 驱动
Resource 提供数据支持,补充知识 静态/动态存储、按需检索
Prompt 引导模型行为,传递任务意图 结构化设计、可嵌套工具/资源

通过 MCP 对这三者的统一管理,模型能够更高效、精准地处理复杂任务,同时降低冗余计算和上下文噪声。

明白这些方法各自作用后,就更方便我们后续接入相关功能。

二、挂载MCP服务

cmd.go文件中可以看到自动挂载服务的方法调用如下图:

然后在app目录下添加mcp模块,创建hook挂载mcp资源相关服务:

添加后后续的toolresourceprompt就可以实现自动注册和绑定到服务中来。

添加自动注册的相关方法:

1. 添加tools工具函数

mcp目录下创建tools目录,该目录用来存放mcp服务所需的工具函数,例如添加一个hello_world工具:

创建一个tool.go用于存放实现自动注册的结构体:

添加hello_world.go添加工具方法:

此时,运行mcp客户端,连接上服务后,可以看到tool工具列表中就有hello_world工具:

输入一个名字"张三"运行,可以看到mcp服务响应了:"Hello, 张三!"。

这时如果我们要再建一个工具就会变得非常方便,只需要再添加一个文件,或在当前文件继续添加方法都是可以的,为了直观展示,我们就再添加一个文件的方式来添加工具:

比如再添加一个工具用于获取指定目录下有哪些文件,添加完后立马就能在mcp客户端使用,而不需要修改其他任何代码。

然后我们通过vscode使用roo插件工具调用大模型来使用mcp提供的工具:

配置好mcp服务后可以看到对应工具

到此,添加工具的集成就完成。

2. 添加promptresource是相同的操作,只需要在对应目录添加对应方法即可

相关推荐
KEEN的创享空间12 小时前
AI编程从0到1之10X提效(Vibe Coding 氛围式编码 )09篇
openai·ai编程
AlienZHOU12 小时前
为 AI Agent 编写高质量 Skill:Claude 官方指南
agent·ai编程·claude
恋猫de小郭13 小时前
移动端开发稳了?AI 目前还无法取代客户端开发,小红书的论文告诉你数据
前端·flutter·ai编程
KaneLogger14 小时前
【翻译】打造 Agent Skills 的最佳实践
agent·ai编程·claude
王小酱14 小时前
Everything Claude Code 文档
openai·ai编程·aiops
太凉15 小时前
select 语句详解
go
雮尘15 小时前
如何在非 Claude IDE (TARE、 Cursor、Antigravity 等)下使用 Agent Skills
前端·agent·ai编程
刘贺同学15 小时前
Day12-龙虾哥打工日记:OpenClaw 子 Agent 到底看到了什么?
aigc·ai编程
程序员鱼皮17 小时前
离大谱,我竟然在 VS Code 里做了个视频!
github·aigc·ai编程
想用offer打牌18 小时前
一站式了解四种限流算法
java·后端·go