La Rebelion MCP Server

🚀 MCP サーバー

MCP サーバーは、モデルコンテキストプロトコル（MCP）を実装したシンプルなサーバーで、モデルコンテキストプロトコルとのやり取りをより簡単にする API を提供します。

🚀 クイックスタート

MCP サーバーを使うことで、モデルコンテキストプロトコルとのやり取りを簡素化できます。以下では、このサーバーの概要、使用理由、新しいサーバーの作成手順、使い方などを説明します。

✨ 主な機能

なぜこのサーバーを使うのか？

"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 @la-rebelion/mcp-server

package.json ファイルを更新し、tsconfig.json ファイルを作成する必要があります。

💻 使用例

基本的な使用法

自分のロジックでツールを実装し、MCPServer で登録します。以下は、簡単な echo ツールの例です。

import { Tool, ToolSchema } from "@la-rebelion/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 { message: input.message };
  }
}

サーバーコードでこのツールをインポートして登録します。

import express from "express";
import { MCP_server } from "@la-rebelion/mcp-server";

const app = express();
app.use("/", new MCP_server([EchoTool]).routes());
app.listen(3000, () => {
  console.log("Server is running on http://localhost:3000");
});

高度な使用法

高度なシナリオでは、独自のツールを作成し、それをサーバーに登録することができます。これにより、特定のニーズに合わせたサーバーを構築できます。

📚 ドキュメント

UML 図

システムの概要を把握するための UML 図を以下に示します。

+-------------------+
|                   |
|     MCP_server    |
|                   |
+-------------------+
          ^
          |
+-------------------+
|                   |
|      EchoTool     |
|                   |
+-------------------+

🤝 サポート

私たちをサポートするには、GitHub スポンサー を購入するか、コーヒーを請う、PayPal で寄付するか、"[La Rebelion]" の商品を購入してください。

📄 ライセンス

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