Upstage MCP Server

🚀 Upstage文檔處理服務器（MCP Server）

Upstage文檔處理服務器（MCP Server）是一款用於解析和提取文檔信息的工具。它支持多種文件格式，能依據預定義或自動生成的模式抽取信息，助力AI模型更高效地處理和理解文檔內容。

🚀 快速開始

在使用Upstage文檔處理服務器前，你需要完成以下先決條件：

1. 獲取有效的Upstage API密鑰，訪問 Upstage控制檯。
2. 安裝Python環境，並確保已安裝所有依賴項（具體要求見項目文檔）。

✨ 主要特性

1. 文檔解析（parse_document）：

   • 描述：處理文檔並提取內容，同時保留結構。
   • 參數：file_path - 需要解析的文檔路徑。
   • 示例查詢：請解析位於 C:\Users\username\Documents\contract.pdf 的文檔，並提供摘要。

2. 信息提取（extract_information）：

   • 描述：基於預定義或自動生成的模式，從文檔中抽取結構化信息。
   • 參數：file_path - 文檔路徑；schema_path（可選）- 包含提取模式的JSON文件；auto_generate_schema（默認為true）- 是否自動生成模式。
   • 示例查詢：請從 C:\Users\username\Documents\invoice.pdf 中提取發票號、日期和總額。

📦 安裝指南

使用uv工具

1. 安裝uvx，並添加到系統路徑中。
2. 在終端運行以下命令啟動服務器：

uvx run --app upstage-mcp-server

配置Claude Desktop

編輯 claude_desktop_config.json 文件，添加如下配置：

{
  "mcp_server": {
    "upstage_mcp_server": {
      "executable_path": "path_to_your_uv_executable",
      "args": [
        "run",
        "--directory",
        "path_to_upstage_mcp_server_directory",
        "python",
        "-m",
        "upstage_mcp_server.server"
      ],
      "env": {
        "UPSTAGE_API_KEY": "your_api_key_here"
      }
    }
  }
}

💻 使用示例

基礎用法

文檔解析

# 假設文檔路徑為 C:\Users\username\Documents\contract.pdf
# 調用文檔解析功能
# 這裡只是示意，實際可能需要根據具體代碼實現調用
# 例如在Python代碼中使用相關函數
# 以下代碼僅為示例，非實際可運行代碼
result = parse_document('C:\Users\username\Documents\contract.pdf')

信息提取

# 假設文檔路徑為 C:\Users\username\Documents\invoice.pdf
# 調用信息提取功能
# 這裡只是示意，實際可能需要根據具體代碼實現調用
# 例如在Python代碼中使用相關函數
# 以下代碼僅為示例，非實際可運行代碼
result = extract_information('C:\Users\username\Documents\invoice.pdf')

📚 詳細文檔

輸出目錄

服務器處理文檔後，輸出結果位於：

• Windows：%APPDATA%\Claude\outputs
• macOS：~/Library/Logs/Claude/output

本地開發設置

安裝依賴項

使用以下命令安裝必要的Python包：

pip install upstage-mcp-server

運行服務器

在項目根目錄下運行：

python -m upstage_mcp_server.server

可用工具

文檔解析（parse_document）

• 描述：處理文檔並提取內容，保留結構。
• 參數：file_path - 需要解析的文檔路徑。

信息提取（extract_information）

• 描述：根據模式從文檔中抽取結構化信息。
• 參數：file_path、schema_path（可選）、auto_generate_schema。

故障排除

常見問題

1. API密鑰缺失：
   • 確保在 claude_desktop_config.json 中正確設置了 UPSTAGE_API_KEY。
2. 文件未找到：
   • 檢查文件路徑的絕對性，並確保沒有特殊字符未被正確轉義。
3. 服務器啟動失敗：
   • 確認虛擬環境已激活，所有依賴項已安裝。檢查Claude Desktop日誌文件。

日誌文件

• Windows：%APPDATA%\Claude\logs
• macOS：~/Library/Logs/Claude

貢獻指南

歡迎社區貢獻！請參考項目文檔的貢獻指南，瞭解如何參與開發和提交代碼。

📄 許可證

該軟件遵循MIT License協議。