mcpサーバー

MCP サーバーは、モデルコンテキストプロトコル (MCP) を実装して、モデルコンテキストプロトコルと対話するためのよりシンプルな APIを提供するシンプルなサーバーです。

このサーバーを使用する理由

「 La Rebelion 」では、プロセスとワークフローを簡素化し、開発者エクスペリエンスの向上と効率化を図るためのツールとサービスの開発に取り組んでいます。このサーバーは、これらのツールセットの一部です。

MCPは素晴らしいツールですが、使い始めるには少し戸惑うかもしれません。そこで、モデルコンテキストプロトコル（MCP）を実装したサーバーの作成プロセスを簡素化する**ファサード**を作成しました。パターンはシンプルで、独自のロジックでtoolsを作成し、登録してサーバーを起動するだけです。

Related MCP server: MCP Server

新しいサーバーを作成する手順

将来的には、 MCP create serverに似た新しいサーバーを作成するための CLI が提供される予定ですが、現時点では、公式ドキュメントに基づいて以下の手順に従ってサーバーを作成できます。

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
# Here lies the 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: { // the schema for the parameters needed by the tool
      type: "object",
      properties: {
        message: { type: "string" },
      },
      required: ["message"],
    },
  };

  /**
   * Your logic here, implement the execute method to define the tool behavior
   * @param input The input message - use the schema to define the input type
   * @returns In the example, we are echoing the message
   */
  async execute(input: any): Promise<any> {
    // This is a simple echo tool demo, nothing fancy, just echoing the message
    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() {
  // Register tools
  myServer.registerTool("echo", EchoTool);
  await myServer.run();
}

main().catch((error) => {
  console.error("Server error:", error);
  process.exit(1);
});

これで完了です！モデルコンテキストプロトコル（MCP）を実装したシンプルなサーバーを作成しました。Claude Desktopまたは MCP をサポートする他のクライアントでテストしてみてください。

次のコマンドでプロジェクトをビルドします。

yarn build

サーバーを起動することはできますが、まだロジックがないので、次のコマンドでテストできます。

yarn start
# or
node build/index.js

これで完了です。ワークフローとプロセスを簡素化するための独自のツールとサービスの作成を開始してください。

頑張れ、反逆者たち！✊🏻

UML図

MCPServer : サーバーが使用するツールを登録します。
Tool : すべてのツールの基本クラスで、共通のプロパティとメソッドが含まれています。execute executeツールが呼び出されたときに呼び出されるメソッドであり、ここでロジックを実装します。
EchoTool : Tool クラスを拡張し、独自のスキーマと初期化ロジックを定義する、ツールの特定の実装。
EchoSchema : EchoTool の入力の構造を定義します。
EchoInput : スキーマに基づいた入力の型定義。

このパターンにより、MCPServer クラスと Tool クラスを使用してツールを管理および実装するための柔軟かつ拡張可能な方法が可能になります。