自定义上下文 MCP 服务器

此 Model Context Protocol (MCP) 服务器提供工具用于根据 JSON 模板对文本进行结构化和数据提取。

功能

文本到 JSON 转换

• 根据包含占位符的 JSON 模板分组和结构化文本
• 从 AI 生成的文本中提取信息并转换为结构化的 JSON 格式
• 支持任意复杂的 JSON 结构，包括嵌套的占位符
• 智能提取文本中的键值对
• 处理 AI 输出以生成供下游应用程序使用的结构化数据

入门指南

安装

npm install

运行服务器

npm start

带有热重载的开发：

npm run dev:watch

使用方法

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

模板格式

模板可以在有效 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\"
        }
    }
}

开发注意事项

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