Agentico MCP Server

🚀 MCP サーバー

MCP Server は、モデルコンテキストプロトコル (MCP) を実装したシンプルなサーバーです。これにより、モデルコンテキストプロトコルとのやり取りを行うためのよりシンプルな API を提供します。

🚀 クイックスタート

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

"La Rebelion" では、開発者の効率を向上させるために、一連のツールとサービスを開発しています。このサーバーは、そのツールセットの一部です。

MCP は非常に強力ですが、初心者には少し使いにくい場合があります。そこで、MCP を使用してサーバーを作成するプロセスを簡素化するために、ファサード を作成しました。このパターンは簡単で、自分のロジックで tools を作成し、ツールを登録してサーバーを起動するだけです。

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

将来的には、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
# ここがポイント
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

✨ 主な機能

コンポーネント

• MCPServer: ツールを管理し、着信リクエストを処理するための核心的なサーバーです。
• Tool と ToolSchema: 外部システムとのやり取り方法を定義するツールインターフェースです。
• main(): サーバーを起動し、すべてのコンポーネントを接続するメイン関数です。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

サポート

いくつかの方法で私たちをサポートすることができます。

La Rebelion GitHub Sponsors で、私たちをサポートするための詳細な情報を見つけることができます。また、"La Rebelion" の商品 を購入することでもサポートすることができます。