MCP 服务器-客户端示例

该项目演示了使用 TypeScript SDK 实现的 Model Context Protocol (MCP) 的基本实现。它包含了一个提供资源访问的服务器和一个连接到服务器并请求资源的客户端，两者通过 stdio 传输进行通信。

概述

该示例包括：

• 提供访问资源的 MCP 服务器
• 连接到服务器并请求资源的 MCP 客户端
• 基本资源列表和读取功能

先决条件

• Node.js (v16 或更高版本)
• npm

安装

克隆仓库并安装依赖项：

npm install

项目结构

src/
  ├── index.ts    # 服务器实现
  └── client.ts   # 客户端实现

运行示例

你需要分别在两个终端窗口中运行服务器和客户端。

1. 启动服务器：

npm run start:server

2. 在新终端中启动客户端：

npm run start:client

客户端将执行以下操作：

1. 连接到服务器
2. 请求可用资源的列表
3. 读取示例资源的内容

服务器功能

当前服务器支持的功能包括：

• 资源列表
• 资源读取
• 基本错误处理（针对未知资源）

可用资源

示例服务器提供以下资源访问权限：

• file:///example.txt：一个简单的文本资源

开发

脚本

• npm run start:server：启动 MCP 服务器
• npm run start:client：启动 MCP 客户端

添加新资源

要添加新资源，请修改 ListResourcesRequestSchema 处理器位于 src/index.ts：

server.setRequestHandler(ListResourcesRequestSchema, async () => {
  return {
    resources: [
      {
        uri: "file:///example.txt",
        name: "Example Resource",
      },
      // 在此处添加新资源
    ],
  };
});

依赖项

• @modelcontextprotocol/sdk：MCP TypeScript SDK
• ts-node：TypeScript 执行环境
• typescript：TypeScript 编译器

许可证

ISC