MCP Server-Client Example

MCP 服务端-客户端示例

本项目使用 TypeScript SDK 演示了模型上下文协议（MCP）的基本实现。项目包含服务端和客户端实现，两者通过 stdio 传输进行通信。

概览

本示例包括：

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

前提条件

• Node.js（v16 或更高版本）
• npm

安装

克隆仓库并安装依赖：

npm install

项目结构

src/
  ├── index.ts    # Server implementation
  └── client.ts   # Client implementation

运行示例

你需要在不同的终端窗口中分别运行服务端和客户端。

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 客户端

添加新资源

如需添加新资源，请修改 src/index.ts 中的 ListResourcesRequestSchema 处理程序：

server.setRequestHandler(ListResourcesRequestSchema, async () => {
  return {
    resources: [
      {
        uri: "file:///example.txt",
        name: "Example Resource",
      },
      // Add new resources here
    ],
  };
});

依赖项

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

许可证

ISC