MCP Server For Veryfi Document Processing

🚀 模型上下文協議（MCP）服務器實現

本項目是一個模型上下文協議（MCP）服務器實現，可與Veryfi集成，用於從文檔中提取數據。通過該服務器，能夠高效地完成文檔數據的提取工作。

🚀 快速開始

✨ 主要特性

• 實現模型上下文協議（MCP）服務器，可與Veryfi集成。
• 支持在Claude Desktop中使用，也可進行本地開發和測試。

📦 安裝指南

使用Claude Desktop

修改claude_desktop_config.json文件，使其包含以下內容：

{
    "mcpServers": {
        "veryfi": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/mcp-server",
                "run",
                "src/server.py"
            ],
            "env": {
                "VERYFI_CLIENT_ID": "...",
                "VERYFI_API_TOKEN": "..."
            }
        }
    }
}

在Claude中，您只需提示即可使用處理文檔和參數。

本地開發

1. 克隆倉庫：將項目倉庫克隆到本地。
2. 創建.env文件：在項目根目錄下創建.env文件，幷包含以下變量：

VERYFI_CLIENT_ID=your_client_id
VERYFI_API_TOKEN=your_api_token

3. 安裝依賴項：運行以下命令安裝所需依賴：

pip install uv
uv sync

4. 本地運行服務器：使用以下命令在本地啟動服務器：

uv run mcp dev src/server.py

💻 使用示例

基礎用法

在Claude Desktop中，按照上述配置好claude_desktop_config.json文件後，在Claude中提示使用處理文檔和參數即可開始從文檔中提取數據。

本地開發使用

按照本地開發的步驟完成安裝和配置後，運行uv run mcp dev src/server.py啟動服務器，即可進行數據提取相關操作。

🔧 技術細節

本項目基於模型上下文協議（MCP）實現服務器，與Veryfi集成以實現文檔數據的提取。在Claude Desktop中，通過配置claude_desktop_config.json文件，指定服務器的命令、參數和環境變量，使其能夠與Claude進行交互。在本地開發時，通過克隆倉庫、配置環境變量、安裝依賴和運行服務器等步驟，搭建本地開發環境。測試方面，使用uv run pytest命令運行測試套件，確保項目的穩定性和正確性。

📄 測試

使用以下命令運行測試套件：

uv run pytest