Ai Agent With MCP

🚀 使用MCP協議的AI代理

本項目實現了一個藉助Model Context Protocol (MCP)與外部資源進行交互的人工智能代理，能夠便捷地訪問和管理相關資源。

🚀 快速開始

安裝

請確保您已經在系統中安裝了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協議與外部資源交互的人工智能代理。
• 提供了MCP客戶端和直接REST API兩種訪問可用資源的方式。

📦 安裝指南

先決條件

• Node.js（與AbortController兼容的版本）
• TypeScript
• @modelcontextprotocol/sdk

安裝步驟

請確保您已經在系統中安裝了Cursor並配置好了npm。在終端中執行以下命令：

# 安裝依賴項
npm install

# 編譯項目
npm run build

# 啟動服務器
npm start

# 在開發模式下運行
npm run dev

💻 使用示例

基礎用法

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訪問

# 列出所有用戶
curl http://3.238.149.189:8080/users

📚 詳細文檔

可用資源

用戶資源

• 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."