Unstructured API MCP Server

🚀 無結構化 MCP 服務器指南

本指南提供了無結構化 MCP 服務器的安裝、啟動、配置等詳細信息，幫助您快速上手使用該服務器。

🚀 快速開始

您可以按照以下步驟快速啟動無結構化 MCP 服務器：

使用虛擬環境安裝

1. 創建並激活 Python 虛擬環境：

   python -m venv ./.venv && source ./.venv/bin/activate
   

2. 安裝項目依賴：

   pip install -r requirements.txt
   

快速安裝（可選）

如果您只需要運行示例，可以使用以下命令直接獲取所有必要文件：

make init

啟動服務器

使用 Make 命令啟動

make server           # 啟動 MCP 服務器（SSE 模式）
make sse-server      # 啟動 SSE 協議服務器
make sse-client      # 運行 SSE 模式的客戶端
make stdio-server    # 啟動 Stdio 協議服務器

手動啟動

1. 啟動 MCP 服務器（SSE 模式）：

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

2. 啟動調試界面：

   mcp dev uns_mcp/server.py
   

✨ 主要特性

• 支持多種啟動方式，包括 Make 命令啟動和手動啟動。
• 提供環境變量配置，可靈活設置日誌級別和 API 請求參數調試輸出。
• 包含工具模塊，可與無結構化服務進行交互。
• 提供調試工具和客戶端終端訪問功能。

📦 安裝指南

使用虛擬環境安裝

1. 創建並激活 Python 虛擬環境：

   python -m venv ./.venv && source ./.venv/bin/activate
   

2. 安裝項目依賴：

   pip install -r requirements.txt
   

快速安裝（可選）

如果您只需要運行示例，可以使用以下命令直接獲取所有必要文件：

make init

💻 使用示例

命令行工具使用示例

啟動命令示例

# 啟動 MCP 服務器（指定端口和 host）
uv run python uns_mcp/server.py --host 127.0.0.1 --port 8080

# 以調試模式啟動
DEBUG=1 uv run python uns_mcp/server.py --host 127.0.0.1 --port 8080

客戶端使用示例

uv run python minimal_client/client.py --help

📚 詳細文檔

項目結構說明

.
├── CHANGELOG.md                  # 版本更新日誌
├── README.md                     # 用戶指南
├── requirements.txt             # 依賴管理文件
├── Makefile                      # 自動化構建腳本
├── uns_mcp/                     # 無結構化 MCP 服務器代碼
│   ├── server.py                # 主服務入口
│   └── __init__.py              # 包初始化文件
└── minimal_client/               # 最小化客戶端代碼
    ├── client.py                 # 客戶端主程序
    ├── __init__.py               # 包初始化文件
    └── tools/                    # 工具模塊
        └── uns_structured.py     # 無結構化工具接口

配置說明

環境變量配置

• LOG_LEVEL：設置日誌級別，可選值為 DEBUG、INFO、WARNING、ERROR，默認為 INFO。
• DEBUG_API_REQUESTS：啟用或禁用 API 請求參數調試輸出，默認為 False。

工具模塊說明

1. minimal_client/tools/uns_structured.py：
   • 提供與無結構化服務交互的接口，包括文件處理、模型調用等功能。

調試工具

使用 Anthropic MCP 檢查器

運行以下命令啟動調試界面：

mcp dev uns_mcp/server.py

客戶端終端訪問

使用 @wonderwhy-er/desktop-commander 包添加終端訪問權限：

1. 安裝包：

   npx @wonderwhy-er/desktop-commander setup
   

2. 啟動客戶端時附加參數：

   uv run python minimal_client/client.py "http://127.0.0.1:8080" --terminal
   

高級主題

擴展開發

• 在 minimal_client/tools/ 目錄下擴展更多工具模塊。

自定義日誌格式

修改 logging_config.yml 文件來自定義日誌輸出格式：

handlers:
  file_handler:
    class: logging.FileHandler
    filename: logs/server.log
    mode: a
    formatter: customFormatter
formatters:
  customFormatter:
    format: "%(asctime)s - %(levelname)s - %(message)s"

🔧 技術細節

已知問題

常見錯誤

• 端口衝突：如果啟動失敗提示端口被佔用，請更換端口：

  uv run python uns_mcp/server.py --host 127.0.0.1 --port 8081
  

故障排除

日誌查看

• 查看服務日誌：

  tail -f uns_mcp/logs/server.log
  

📄 許可證

文檔中未提及許可證相關信息。

文檔歷史

修改記錄

• v1.0：初始版本發佈，包含基本功能和文檔。
• v1.1：新增調試工具支持，優化日誌系統。

如需更多幫助，請參考項目源碼或聯繫維護團隊。