模型上下文协议示例

用于教学目的的简单模型上下文协议(MCP)客户端和服务器示例,包含计算器和问候工具。

  • by kmh4500
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 kmh4500/mcp-client-server-intent-example

使用说明

MCP类示例

此存储库包含用于教学目的的简单模型上下文协议(MCP)客户端和服务器示例。

设置

  1. 安装依赖项:
npm install

运行示例

选项1:运行客户端(自动启动服务器)

npm run start:client

这将:

  • 启动MCP服务器
  • 将客户端连接到服务器
  • 运行可用工具的演示
  • 进入交互模式,您可以在其中测试命令

选项2:分别运行服务器和客户端

终端1(服务器):

npm run start:server

2号航站楼(客户端):

node client.js

可用工具

服务器提供了两个示例工具:

1.计算器(calculate)

执行基本算术运算。

参数:

  • operation:“加”、“减”、“乘”、“除”
  • a:第一个数字
  • b:第二个数字

例子:

calculate add 5 3

2.迎宾员(greet)

生成不同语言的问候语。

参数:

  • name:要问候的名字
  • language:“英语”、“西班牙语”、“法语”(可选,默认为“英语”)

例子:

greet Alice english
greet Carlos spanish

交互模式命令

运行客户端时,您可以在交互模式下使用以下命令:

  • calculate add 5 3
  • calculate multiply 7 8
  • greet Alice english
  • greet Bob spanish
  • quit

学习目标

此示例演示了:

  1. 如何使用工具创建基本的MCP服务器
  2. 如何创建连接到服务器的MCP客户端
  3. 带有输入模式的工具定义
  4. MCP中的错误处理
  5. 交互式客户端-服务器通信

文件结构

  • server.js -使用计算器和迎宾工具实现MCP服务器
  • client.js -连接到服务器并演示工具使用的MCP客户端
  • package.json -带依赖项的Node.js项目配置