Custom Context MCP

🚀 自定義上下文 MCP 服務器

本 Model Context Protocol (MCP) 服務器提供了一系列工具，可依據 JSON 模板對文本進行結構化處理和數據提取，有效解決了從非結構化文本中獲取結構化數據的難題，為下游應用程序提供了便利。

🚀 快速開始

安裝

npm install

運行服務器

npm start

若需帶有熱重載的開發模式，可使用以下命令：

npm run dev:watch

✨ 主要特性

文本到 JSON 轉換

• 依據包含佔位符的 JSON 模板對文本進行分組和結構化處理。
• 從 AI 生成的文本中提取信息，並將其轉換為結構化的 JSON 格式。
• 支持任意複雜的 JSON 結構，包括嵌套的佔位符。
• 智能提取文本中的鍵值對。
• 處理 AI 輸出，生成可供下游應用程序使用的結構化數據。

📦 安裝指南

安裝依賴項

npm install mcp-server mcp-inspector uuid express

啟動服務器

要啟動 MCP 服務器，請運行以下命令：

node index.js

默認情況下，服務器將在端口 3000 上運行。

💻 使用示例

此 MCP 服務器提供兩個主要工具：

基礎用法

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"
    }
}

示例請求

使用 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"
        }
    }
}

📚 詳細文檔

模板格式

模板可以在有效 JSON 結構中的任何位置包含佔位符：

• 使用尖括號定義佔位符：<name>，<type>，<price> 等。
• 模板必須是一個有效的 JSON 字符串。
• 佔位符可以出現在任意嵌套級別。
• 支持複雜的嵌套結構。 包含嵌套佔位符的示例模板：

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

🔧 技術細節

開發注意事項

• 請確保安裝所有依賴項。
• 確保服務器在正確的端口上運行。
• 在處理大量數據時，考慮性能優化。