Key Value Extractor

🚀 Flexible Key 提取器 MCP サーバー

強力な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（および貢献者）