链载Ai

标题: MCP 三大核心概念(2): 用MCP实现数据调用、API执行与模板生成的完整链条 [打印本页]

作者: 链载Ai    时间: 昨天 12:27
标题: MCP 三大核心概念(2): 用MCP实现数据调用、API执行与模板生成的完整链条


ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 14px;letter-spacing: 0.1em;color: rgb(63, 63, 63);">下面我会模拟三个“虚拟文件”,分别代表 Resources、Tools 和 Prompts,通过这些“文件”的内容来说明它们在 MCP 中的用法。每个文件都会有实际代码或伪代码,尽量贴近真实开发场景。


ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;padding-left: 8px;color: rgb(63, 63, 63);">文件 1:Resources 用法展示

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 14px;letter-spacing: 0.1em;color: rgb(63, 63, 63);">ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: inherit;color: rgb(15, 76, 129);">文件名:server_logs.txt
ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: inherit;color: rgb(15, 76, 129);">描述:假设这是一个服务器日志文件,通过 MCP 的 Resources 暴露给 LLM,让它分析错误。
ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: inherit;color: rgb(15, 76, 129);">内容

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-feature-settings: normal;font-variation-settings: normal;font-size: 14px;margin: 10px 8px;color: rgb(201, 209, 217);background: rgb(13, 17, 23);text-align: left;line-height: 1.5;overflow-x: auto;border-radius: 8px;padding: 0px !important;">[2025-02-22 10:00:01] ERROR: Database connection failed - Timeout
[2025-02-22 10:00:05] INFO: Retry attempt 1
[2025-02-22 10:00:10] ERROR: Database connection failed - Timeout
[2025-02-22 10:00:15] FATAL: System shutdown

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 14px;letter-spacing: 0.1em;color: rgb(63, 63, 63);">ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: inherit;color: rgb(15, 76, 129);">MCP 配置(伪代码):

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-feature-settings: normal;font-variation-settings: normal;font-size: 14px;margin: 10px 8px;color: rgb(201, 209, 217);background: rgb(13, 17, 23);text-align: left;line-height: 1.5;overflow-x: auto;border-radius: 8px;padding: 0px !important;">// 在 MCP 服务器上暴露日志文件作为 Resource
const server = new Server({
name: "log-server",
version: "1.0.0"
}, {
capabilities: { resources: {} }
});

// 列出可用资源
server.setRequestHandler("resources/list", async () => {
return {
resources: [{
uri: "file:///logs/server_logs.txt",
name: "Server Logs",
mimeType: "text/plain"
}]
};
});

// 读取资源内容
server.setRequestHandler("resources/read", async (request) => {
if (request.params.uri === "file:///logs/server_logs.txt") {
const logs = await readFile("server_logs.txt");
return {
contents: [{ uri: request.params.uri, mimeType: "text/plain", text: logs }]
};
}
throw new Error("Resource not found");
});

用法解析:


文件 2:Tools 用法展示

文件名:weather_tool.py
描述:这是一个天气查询工具,通过 MCP 的 Tools 功能让 LLM 调用外部 API 获取实时天气。
内容

# Python MCP 服务器定义工具
from mcp.server import Server
import requests

app = Server("weather-server")

定义天气查询工具
@app.tool("get_weather")
async def get_weather(city: str) -> str:
url = f"http://api.weatherapi.com/v1/current.json?key=YOUR_API_KEY&q={city}"
response = requests.get(url).json()
temp = response["current"]["temp_c"]
condition = response["current"]["condition"]["text"]
return f"{city} 当前温度: {temp}°C,天气: {condition}"

启动服务器
async def main():
async with app.stdio_server():
await app.run()

用法解析


文件 3:Prompts 用法展示

文件名:error_report_template.md
描述:这是一个错误报告模板,通过 MCP 的 Prompts 功能提供给 LLM,生成标准化的报告。
内容

错误报告
日志文件: {log_file}
错误概要
{summary}
详细分析
{analysis}
修复建议
{suggestions}

MCP 配置(伪代码)

const server = new Server({
name: "report-server",
version: "1.0.0"
}, {
capabilities: { prompts: {} }
});

// 定义 Prompt 模板
server.setRequestHandler("prompts/list", async () => {
return {
prompts: [{
id: "error_report",
name: "Error Report Generator",
template: await readFile("error_report_template.md"),
parameters: ["log_file", "summary", "analysis", "suggestions"]
}]
};
});

用法解析


三者如何协作:

假设我把这三个文件都“上传”到一个 MCP 支持的客户端(比如 Claude Desktop):

  1. 1. Resources (server_logs.txt):LLM 先读取日志,获取上下文。
  2. 2. Tools (weather_tool.py):如果我顺便问了“今天天气如何影响服务器”,LLM 调用工具查天气。
  3. 3. Prompts (error_report_template.md):最后用模板把日志分析和天气数据整合成报告。
最终输出(模拟):
错误报告
日志文件: server_logs.txt
错误概要
数据库连接超时导致系统崩溃
详细分析
日志显示多次超时,可能是网络问题。今日上海天气多云,温度15°C,未见极端情况。
修复建议
检查数据库端口和网络稳定性,排除硬件故障。

写到最后

通过上面的例子,模拟了“上传文件”的直观体验,展示了 MCP 这仨概念怎么落地。现实中,MCP 需要服务器和客户端支持,但原理就是这么简单直接。






欢迎光临 链载Ai (https://www.lianzai.com/) Powered by Discuz! X3.5