Mcphackathon

🚀 非構造化データ処理システム

このシステムは、非構造化データを効果的に処理し、AnthropicのMCP（機械学習プラットフォーム）サーバーを利用してClaudeデスクトップ環境に統合することができます。非構造化データの特徴や処理方法を理解し、システムのセットアップと実行を行うことができます。

🚀 クイックスタート

このセクションでは、非構造化データの概要とAnthropicのMCPサーバーを使用したシステムのセットアップ方法について説明します。

✨ 主な機能

非構造化データの概要

1. 概要

• 非構造化データとは、固定フォーマットを持たないデータのことで、テキスト、画像、ビデオなどが含まれます。
• 現在のデジタル時代では、90%以上のデータが非構造化データであり、電子メール、ドキュメント、ソーシャルメディアの投稿などが含まれます。

2. 特徴

• 高い柔軟性：非構造化データは任意の形式で存在することができ、保存や転送が容易です。
• 処理が難しい：固定フォーマットがないため、データ分析や機械学習モデルに直接使用することが難しいです。

3. 処理方法

1. データ抽出：自然言語処理（NLP）技術を使用して、テキストから有用な情報を抽出します。
2. データアノテーション：非構造化データにラベルやメタデータを付けて、管理しやすくします。
3. データ変換：非構造化データを構造化フォーマットに変換して、さらなる分析を行います。

4. 応用シーン

• テキストマイニング：大量のドキュメントから有用な情報を抽出します。
• 感情分析：ソーシャルメディアの投稿の感情傾向を分析します。
• 画像認識：画像内の物体やシーンを認識します。

📦 インストール

インストール手順

1. 依存関係のインストール：

   pip install uvicorn python-dotenv
   

2. MCPサーバーの起動：

   uv run python uns_mcp/server.py --host 0.0.0.0 --port 8080
   

設定ファイル

• config.json ファイルの作成：

  {
      "mcpServers": {
          "UNS_MCP": {
              "command": "ABSOLUTE/PATH/TO/.local/bin/uv",
              "args": [
                  "--directory",
                  "ABSOLUTE/PATH/TO/YOUR-UNS-MCP-REPO/uns_mcp",
                  "run",
                  "server.py"
              ],
              "env": [
                  "UNSTRUCTURED_API_KEY": "<your key>"
              ]
          }
      }
  }
  

Claudeデスクトップへの統合

1. claude_desktop_config.json ファイルの編集：

   # macOSまたはLinuxの場合：
   code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   
   # Windowsの場合：
   code $env:AppData\Claude\claude_desktop_config.json
   

2. MCPサーバーの設定の追加：

   {
       "mcpServers": {
           "UNS_MCP": {
               "command": "ABSOLUTE/PATH/TO/.local/bin/uv",
               "args": [
                   "--directory",
                   "ABSOLUTE/PATH/TO/YOUR-UNS-MCP-REPO/uns_mcp",
                   "run",
                   "server.py"
               ],
               "env": [
                   "UNSTRUCTURED_API_KEY": "<your key>"
               ]
           }
       }
   }
   

3. Claudeデスクトップの再起動。

デバッグツール

• MCP Inspector ツールを使用して、MCPサーバーのデバッグ/テストを行います：

  mcp dev uns_mcp/server.py
  

• リクエストパラメータを記録するための環境変数の設定：

  DEBUG_API_REQUESTS=false
  

💻 使用例

基本的な使用法

サーバー側の実行

# 1つのターミナルでサーバーを起動します：
uv run python uns_mcp/server.py --host 127.0.0.1 --port 8080

# または
make sse-server

クライアント側の実行

# 別のターミナルでクライアントを起動します：
uv run python minimal_client/client.py "http://127.0.0.1:8080/sse"
# または
make sse-client

⚠️ 重要提示

まず ctrl+c を使用してクライアントを終了し、その後サーバーを閉じてください。そうしないと、サーバーがハングする可能性があります。