MCP Server Client

🚀 MCP サーバー - クライアントサンプル

このプロジェクトは、TypeScript SDK を使用した基本的な Model Context Protocol (MCP) の実装を示しています。リソースへのアクセスを提供する 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 クライアントを起動する

新しいリソースの追加

サーバーに新しいリソースを追加するには、src/index.ts の ListResourcesRequestSchema ハンドラーを変更します。

server.setRequestHandler(ListResourcesRequestSchema, async () => {
  return {
    resources: [
      {
        uri: "file:///example.txt",
        name: "Example Resource",
      },
      // ここに新しいリソースを追加する
    ],
  };
});

依存関係

• @modelcontextprotocol/sdk：MCP TypeScript SDK
• ts-node：TypeScript 実行環境
• typescript：TypeScript コンパイラ

📄 ライセンス

ISC