Key Value Extractor

🚀 灵活键值提取器 MCP 服务器

一个功能强大的 MCP（消息中心代理）服务器，可从任意噪声文本中提取键值对并进行结构化处理。该服务器借助 OpenAI 模型实现智能信息抽取，还提供灵活配置选项，以满足不同场景需求。

🚀 快速开始

本服务器是一个强大的 MCP（Message Center Proxy）服务器，可从任意噪声文本中提取键值对并进行结构化处理。支持通过 OpenAI 模型实现智能信息抽取，还提供灵活的配置选项以适应不同场景需求。

✨ 主要特性

• 多格式支持：支持将提取的内容输出为 JSON、YAML 和 TOML 格式。
• 类型安全：提供严格的数据验证和类型检查，确保输出结果的可靠性。
• 日志管理：提供灵活的日志配置选项，用户可按需选择开启或关闭日志记录功能，并指定日志文件的存储路径。
• 扩展性好：支持通过插件机制进行功能扩展，便于集成到现有系统中。

📦 安装指南

通过 Smithery 安装

要自动使用 Smithery 在 Claude Desktop 上安装 kv - extractor - mcp - server，请执行以下命令：

npx -y @smithery/cli install @KunihiroS/kv-extractor-mcp-server --client claude

系统要求

• Python 3.9+
• 配置 OpenAI API 密钥（在 settings.json 的 env 下设置）

启动服务器

python server.py

如果需要手动运行服务器，请参考上述命令。

📚 详细文档

MCP 主机配置

当运行此 MCP 服务器时，您必须通过命令行参数显式指定日志输出模式以及（如果启用）绝对的日志文件路径。

• --log=off：禁用所有日志记录功能。
• --log=on --logfile=/absolute/path/to/logfile.log：启用日志记录功能并将日志写入指定的绝对文件路径。

示例：日志关闭

"kv-extractor-mcp-server": {
  "command": "pipx",
  "args": ["run", "kv-extractor-mcp-server", "--log=off"],
  "env": {
    "OPENAI_API_KEY": "{apikey}"
  }
}

示例：日志启用（必须指定绝对日志文件路径）

"kv-extractor-mcp-server": {
  "command": "pipx",
  "args": ["run", "kv-extractor-mcp-server", "--log=on", "--logfile=/workspace/logs/kv-extractor-mcp-server.log"],
  "env": {
    "OPENAI_API_KEY": "{apikey}"
  }
}

⚠️ 重要提示

• 当启用日志记录功能时，仅将日志写入指定的绝对文件路径。相对路径或未指定 --logfile 参数都会导致服务器启动失败。
• 当禁用日志记录功能时，不会输出任何日志信息。
• 如果缺少必要的参数或指定的路径无效，服务器将无法启动并会显示错误消息。
• 确保日志文件对 MCP 服务器进程可写。

📄 许可证

GPL - 3.0 - or - later

👨‍💻 作者

KunihiroS（以及贡献者）