Joeblockchain MCP Server Client

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

このプロジェクトは、TypeScript SDKを使用したModel Context Protocol (MCP) の基本的な実装をデモンストレーションします。標準入出力 (stdio) を介して通信する、リソースへのアクセスを提供するサーバーと、サーバーに接続してリソースを要求するクライアントが含まれています。

🚀 クイックスタート

このサンプルを実行する前に、必要なソフトウェアをインストールし、サーバーとクライアントを起動する必要があります。以下の手順に従って操作してください。

✨ 主な機能

• MCPサーバーによるリソースへのアクセス提供
• MCPクライアントによるサーバーへの接続とリソース要求
• 基本的なリソースリストと読み取り機能

📦 インストール

まず、リポジトリをクローンし、依存関係をインストールします。

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