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

🔧 技术细节

开发注意事项

• 请确保安装所有依赖项。
• 确保服务器在正确的端口上运行。
• 在处理大量数据时，考虑性能优化。