MCP Server-Client Example

MCP サーバー・クライアントの例

このプロジェクトでは、TypeScript SDK を使用した Model Context Protocol（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