Mcphackathon

🚀 無結構化內容處理系統

本項目聚焦於無結構化數據的處理，提供了一套完整的解決方案，包括對無結構化數據的特點分析、處理方法介紹，以及如何使用 Anthropic 的 MCP 服務器進行數據處理，並集成到 Claude 桌面環境中，方便開發者進行開發和調試。

🚀 快速開始

本項目主要圍繞無結構化數據處理展開，藉助 Anthropic 的 MCP 服務器，可實現無結構化數據的處理與分析，並集成到 Claude 桌面環境中。以下是使用該系統的快速步驟：

1. 瞭解無結構化數據的特點和處理方法。
2. 安裝並配置 Anthropic 的 MCP 服務器。
3. 將 MCP 服務器集成到 Claude 桌面。
4. 運行本地最小客戶端訪問 MCP 服務器進行開發和調試。

✨ 主要特性

無結構化數據特點

• 靈活性高：無結構化數據可以以任何形式存在，易於存儲和傳輸。
• 難以處理：由於缺乏固定格式，難以直接用於數據分析和機器學習模型。

處理方法優勢

• 數據提取：使用自然語言處理（NLP）技術從文本中提取有用信息，為後續分析提供基礎。
• 數據標註：為無結構化數據添加標籤或元數據，使其更易於管理和檢索。
• 數據轉換：將無結構化數據轉換為結構化格式，以便進行進一步分析和建模。

📦 安裝指南

安裝依賴項

pip install uvicorn python-dotenv

運行 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 桌面

編輯 claude_desktop_config.json 文件

# 對於 macOS 或 Linux：
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# 對於 Windows：
code $env:AppData\Claude\claude_desktop_config.json

添加 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>"
            ]
        }
    }
}

重啟 Claude 桌面

完成上述配置後，重啟 Claude 桌面使配置生效。

調試工具

使用 MCP Inspector 工具調試/測試 MCP 服務器

mcp dev uns_mcp/server.py

設置環境變量以記錄請求參數

DEBUG_API_REQUESTS=false

運行本地最小客戶端和訪問 MCP 服務器

服務器端運行

# 在一個終端中運行服務器：
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 退出客戶端，然後關閉服務器。否則，服務器可能會掛起。

通過以上步驟，你可以完整地設置和運行一個基於 Anthropic MCP 的無結構化數據處理系統，並將其集成到 Claude 桌面環境中進行進一步的開發和調試。