MCP 服务器-客户端示例

该项目展示了使用 TypeScript SDK 实现的基本 Model Context Protocol (MCP) 的实现。它包含一个提供资源访问的 MCP 服务器和一个连接到服务器并请求资源的客户端。

概述

此示例包括：

• 提供访问资源的 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