Agentico MCP Server

🚀 MCP 服務器

MCP Server 是一款簡易服務器，實現了模型上下文協議 (MCP)，旨在提供更簡潔的 API 以實現與模型上下文協議的交互。

🚀 快速開始

MCP 非常強大，但對於新手來說可能有點難以入門。我們創建了一個 門面 來簡化使用 MCP 創建服務器的過程。該模式很簡單，你只需要用你自己的邏輯創建 tools，註冊工具並啟動服務器即可。

創建新服務器的步驟

未來我們將提供一個 CLI 工具來創建類似 MCP create server 的新服務器，但目前你可以按照以下步驟基於官方文檔創建服務器：

mkdir -p my-server/src
cd my-server/
yarn init -y
yarn add @modelcontextprotocol/sdk zod zod-to-json-schema
yarn add -D @types/node typescript
# 這裡是 magic
yarn add @agentico/mcp-server

你需要更新 package.json 文件並創建一個 tsconfig.json 文件。

代碼實現

用你自己的邏輯實現工具，並在 MCPServer 中註冊它們。以下是一個簡單的 echo 工具示例：

import { Tool, ToolSchema } from "@agentico/mcp-server";

export class EchoTool extends Tool {
  toolSchema: ToolSchema = { 
    name: "echo",
    description: "Echoes the input message",
    schema: { // 工具所需的參數模式
      type: "object",
      properties: {
        message: { type: "string" },
      },
      required: ["message"],
    },
  };

  /**
   * 在這裡實現你的邏輯，定義工具的行為
   * @param input 輸入消息 - 使用模式定義輸入類型
   * @returns 示例中，我們只是簡單地回顯消息
   */
  async execute(input: any): Promise<any> {
    // 這是一個簡單的回顯工具演示，沒有複雜的功能，只是回顯消息
    return Promise.resolve({
      content: [
        {
          type: "text",
          text: `${input.message}` 
        }
      ]
      });
  }
}

創建一個 index.ts 文件，內容如下：

#!/usr/bin/env node
import { MCPServer } from '@agentico/mcp-server'
import { EchoTool } from "./tools/EchoTool.js";

const myServer = new MCPServer('My MCP Server', '1.0.0');

async function main() {
  // 註冊工具
  myServer.registerTool("echo", EchoTool);
  await myServer.run();
}

main().catch((error) => {
  console.error("服務器錯誤:", error);
  process.exit(1);
});

就這樣！你已經創建了一個實現模型上下文協議的簡單服務器。使用 Claude Desktop 或任何支持 MCP 的其他客戶端進行測試。

使用以下命令構建項目：

yarn build

✨ 主要特性

在 "La Rebelion" 中，我們正在開發一系列工具和服務，旨在簡化流程和工作流，以提高開發者的效率體驗。這個服務器是我們工具集的一部分。

🔧 技術細節

組件

• MCPServer: 用於管理工具和處理傳入請求的核心服務器。
• Tool 和 ToolSchema: 定義如何與外部系統交互的工具接口。
• main(): 啟動服務器並將所有內容連接在一起的主函數。

🤝 支持

你可以通過多種方式支持我們： 你可以在 La Rebelion GitHub Sponsors 找到更多支持我們的信息，或者通過購買 "La Rebelion" 商品 來支持我們。

📄 許可證

該項目在 MIT License 下許可 - 有關詳細信息，請參閱 LICENSE 文件。