MCP Server-Client Example

What is MCP Server-Client Example?

This project demonstrates a basic implementation of the Model Context Protocol (MCP) using the TypeScript SDK. It includes both an MCP server and client that communicate over stdio transport, providing resource listing and reading functionality.

How to use MCP Server-Client Example?

Clone the repository, install dependencies with npm install, then start the server with npm run start:server and the client with npm run start:client in separate terminal windows. The client connects to the server, requests a list of available resources, and reads the content of an example resource.

Key features of MCP Server-Client Example

• MCP server and client implementation over stdio transport
• Resource listing and reading via MCP protocol
• Example resource accessible at file:///example.txt
• Basic error handling for unknown resources

Use cases of MCP Server-Client Example

• Learning how to implement MCP server-client communication
• Prototyping MCP resource access workflows
• Testing MCP SDK integration with TypeScript

FAQ from MCP Server-Client Example

What are the runtime requirements?

Node.js v16 or higher and npm.

What dependencies does the project use?

The @modelcontextprotocol/sdk, ts-node, and typescript packages.

How do I add a new resource?

Modify the ListResourcesRequestSchema handler in src/index.ts and add the new resource URI and name to the returned resources array.

What transport protocol does MCP Server-Client Example use?

Communication between server and client uses stdio transport.