🎓 掌握模型上下文协议(MCP)-课程报告
欢迎来到 掌握MCP 课程库! 🚀
这个仓库是你学习的游乐场 模型上下文协议(MCP)它包含一系列独立的项目,每个项目都旨在教授您构建MCP服务器和客户端的具体概念。
______________________________________________________________________
📚 什么是模型上下文协议(MCP)?
这 模型上下文协议(MCP) 是一个开放标准,使人工智能模型(如Claude)能够安全地与本地或远程资源进行交互。它充当AI和您的数据/工具之间的通用翻译器。
核心概念
- MCP服务器:公开功能(工具、资源、提示)的后端应用程序。
- MCP客户端:使用这些功能的前端应用程序(例如Claude Desktop、IDE)。
- 工具:可执行函数(例如,“计算税款”、“获取天气”)。
- 资源:静态或动态数据(例如“文件内容”、“数据库行”)。
- 鼓励:用于人工智能交互的可重用模板。
______________________________________________________________________
⚡ 入门(全球)
先决条件
在运行此仓库中的任何项目之前,请确保您已经:
- Node.js (v16或更高版本)已安装。
- NPM (节点包管理器)。
安装
克隆此存储库并安装共享依赖项:
npm install______________________________________________________________________
📂 可用项目
这个存储库被组织成不同的示例。下面是您可以运行和探索的可用项目列表。
1.️⃣ 项目1:货币兑换服务器
聚焦:MCP、工具和标准传输的基础知识。
该项目实现了一个简单的MCP服务器,该服务器提供了一个使用实时汇率转换货币的工具。
- 主文件:
currencyConvertor.js - 主要特点:
- 定义自定义工具 currencyConverter. - 用途 zod 用于输入验证。 - 从外部API获取数据。
如何跑步
node currencyConvertor.js代码深潜(货币转换器)
Click to expand explanation
1.服务器设置
const server = new McpServer({
name: "Currency Converter MCP server",
version: "1.0.0",
});2.工具定义
server.tool(
"currencyConverter",
"Convert Amount from one currency to another",
{
amount: z.number(),
from: z.string(),
to: z.string(),
},
async ({ amount, from, to }) => { ... }
);3.连接
const transport = new StdioServerTransport();
await server.connect(transport);🔌 连接到克劳德桌面
将此添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"currency-converter": {
"command": "node",
"args": ["C:\\path\\to\\this\\repo\\currencyConvertor.js"]
}
}
}______________________________________________________________________
2.️⃣ 项目2:(即将推出)
*请继续关注更多涵盖资源和提示的高级示例!*
______________________________________________________________________
🎮 互动式教学法
要真正掌握MCP,请在现有项目上尝试以下挑战:
- 修改货币转换器:添加a
listCurrencies工具。 - 创建新服务器:创建一个名为的文件
helloWorld.js并构建一个服务器,该服务器有一个工具可以说“你好,\[名称\]!”。
______________________________________________________________________
快乐学习! 🌟
