Custom Context MCP

🚀 カスタムコンテキストMCPサーバー

このModel Context Protocol (MCP) サーバーは、JSONテンプレートに基づいてテキストを構造化し、データを抽出するためのツールを提供します。

✨ 主な機能

テキストからJSONへの変換

• プレースホルダーを含むJSONテンプレートに基づいて、テキストをグループ化し構造化する
• AIが生成したテキストから情報を抽出し、構造化されたJSON形式に変換する
• ネストされたプレースホルダーを含む任意の複雑なJSON構造をサポートする
• テキスト内のキーバリューペアをスマートに抽出する
• AIの出力を処理し、下流のアプリケーションで使用するための構造化データを生成する

🚀 クイックスタート

📦 インストール

npm install

サーバーの起動

npm start

ホットリロード付きの開発：

npm run dev:watch

💻 使用例

このMCPサーバーは、2つの主要なツールを提供します：

1. 按JSON分组文本 (group-text-by-json)

このツールは、プレースホルダーを含むJSONテンプレートを受け取り、AIにテンプレート構造に基づいてテキストをグループ化するように指示するプロンプトを生成します。

{
    "template": "{ \"type\": \"<type>\", \"text\": \"<text>\" }"
}

このツールはテンプレートを分析し、プレースホルダーのキーを抽出し、AIにキーバリュー形式で情報を抽出するように指示するプロンプトを返します。

2. 文本到JSON (text-to-json)

このツールは、前のステップで生成されたグループ化されたテキストを受け取り、元のテンプレートに基づいて構造化されたJSONオブジェクトに変換します。

{
    "template": "{ \"type\": \"<type>\", \"text\": \"<text>\" }",
    "text": "type: pen\ntext: This is a blue pen"
}

このツールは、テキストからキーバリューペアを抽出し、テンプレートに基づいて構造化します。

基本的な使用法

サンプルワークフロー

1. プレースホルダーを含むJSONテンプレートを定義する：

{
    "item": {
        "name": "<name>",
        "price": "<price>",
        "description": "<description>"
    }
}

2. group-text-by-json を使用してAIプロンプトを生成する：
   • ツールがプレースホルダーのキー（名前、価格、説明）を識別する
   • AIにこれらのキーで情報を抽出するように指示するプロンプトを生成する
3. プロンプトをAIモデルに送信し、グループ化されたテキストを受け取る：

name: Blue Pen
price: $2.99
description: A smooth-writing ballpoint pen with blue ink

4. text-to-json を使用してグループ化されたテキストをJSONに変換する：

{
    "item": {
        "name": "Blue Pen",
        "price": "$2.99",
        "description": "A smooth-writing ballpoint pen with blue ink"
    }
}

高度な使用法

テンプレート形式

テンプレートは、有効なJSON構造内の任意の位置にプレースホルダーを含むことができます。

• プレースホルダーは、山括弧で定義されます：<name>、<type>、<price> など
• テンプレートは、有効なJSON文字列である必要があります
• プレースホルダーは、任意のネストレベルで出現することができます
• 複雑なネスト構造をサポートします

ネストされたプレースホルダーを含むサンプルテンプレート：

{
    "product": {
        "details": {
            "name": "<name>",
            "category": "<category>"
        },
        "pricing": {
            "amount": "<price>",
            "currency": "USD"
        }
    },
    "metadata": {
        "timestamp": "2023-09-01T12:00:00"
    }
}

インストールとサーバーの起動

npm install mcp-server mcp-inspector uuid express

MCPサーバーを起動するには、以下を実行します：

node index.js

デフォルトでは、サーバーはポート 3000 で実行されます。

サンプルリクエスト

curl または任意のHTTPクライアントを使用して、以下のリクエストを http://localhost:3000/process に送信します：

{
    "template": {
        "product": {
            "details": {
                "name": "<name>",
                "category": "<category>"
            },
            "pricing": {
                "amount": "<price>",
                "currency": "USD"
            }
        }
    },
    "text": "The product is a new electronic gadget priced at $49.99, category: electronics"
}

レスポンス

{
    "product": {
        "details": {
            "name": "The product",
            "category": "electronics"
        },
        "pricing": {
            "amount": "49.99",
            "currency": "USD"
        }
    }
}

🔧 開発上の注意事項

• すべての依存関係をインストールしてください
• サーバーが正しいポートで実行されていることを確認してください
• 大量のデータを処理する場合は、パフォーマンスの最適化を検討してください