Ai Agent With MCP

🚀 Model Context Protocol (MCP) を使用したAIエージェント

このプロジェクトは、Model Context Protocol (MCP) を使用して外部リソースとやり取りする人工知能エージェントを実装しています。

🚀 クイックスタート

このセクションでは、MCPを使用したAIエージェントの基本的な使い方を説明します。

✨ 主な機能

• Model Context Protocol (MCP) を使用して外部リソースとやり取りする。
• ユーザーリソースとメッセージリソースにアクセスできる。
• Cursor上での簡単なインストールと実行が可能。

📦 インストール

Cursor上でのインストール

システムにCursorがインストールされ、npmが設定されていることを確認してください。

オプション1：ターミナルを通じたインストール

ターミナルで以下のコマンドを実行します。

# 依存関係のインストール
npm install

# プロジェクトのコンパイル
npm run build

# サーバーの起動
npm start

# 開発モードでの実行
npm run dev

💻 使用例

基本的な使用法

MCPクライアント

このプロジェクトには、利用可能なリソースにアクセスするためのMCPクライアントが含まれています。

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

async function main() {
  const client = new Client({
    name: "hello-mcp-client",
    version: "1.0.0"
  });
  const transport = new StdioClientTransport({
    command: "node",
    args: ["build/index.js"]
  });
  
  try {
    await client.connect(transport);
    
    // 利用可能なリソースをリストする
    const resources = await client.listResources();
    console.log("利用可能なリソース:", resources);
    
    // ユーザーリソースの内容を読み取る
    const content = await client.readResource({ uri: "api://users" });
    console.log("\nユーザーリスト:", content);
  } catch (error) {
    console.error("クライアントの実行中にエラーが発生しました:", error);
  }
}

main().catch(console.error);

直接のREST APIアクセス

直接のREST APIを使用してリソースにアクセスすることもできます。

# すべてのユーザーをリストする
curl http://3.238.149.189:8080/users

📚 ドキュメント

利用可能なリソース

MCPサーバーは以下のリソースを提供します。

ユーザーリソース

• api://users: システムに登録されているすべてのユーザーをリストします。
  • 返される情報には、ID、名前、電話番号、スレッドIDが含まれます。
  • 形式：JSON
  • 応答例：

    {
      "content": [
        {
          "id": 1,
          "phoneNumber": "553496341404",
          "name": "Moisés Paschoalick",
          "threadId": "thread_bZEPVYVBvHxY9Ok6WqR63M2D"
        },
        {
          "id": 2,
          "phoneNumber": "553496338888",
          "name": "José Silva",
          "threadId": "1thread_t8SFjKio6yN9pppqypilwGoR__"
        },
        {
          "id": 3,
          "phoneNumber": "553496338889",
          "name": "Maria Antonia",
          "threadId": "1thread_t8SFjKio6yN9pppqypilwGoR__"
        }
      ],
      "pageable": {
        "pageNumber": 0,
        "pageSize": 12,
        "sort": {
          "empty": false,
          "sorted": true,
          "unsorted": false
        },
        "offset": 0,
        "paged": true,
        "unpaged": false
      },
      "last": true,
      "totalPages": 1,
      "totalElements": 3,
      "first": true,
      "size": 12,
      "number": 0,
      "sort": {
        "empty": false,
        "sorted": true,
        "unsorted": false
      },
      "numberOfElements": 3,
      "empty": false
    }
    

メッセージリソース

• hello://world: 単純な挨拶メッセージを返します。
  • 形式：純テキスト (text/plain)
  • 応答例："Hello, World! This is my first MCP resource."

🔧 技術詳細

前提条件

• Node.js（AbortControllerと互換性のあるバージョン）
• TypeScript
• @modelcontextprotocol/sdk