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（以及貢獻者）