Metis MCP Demo

🚀 Metis MCP 工具

Metis MCP 工具是一組用於增強 Metis RAG 應用程序的工具，藉助 Model Context Protocol (MCP) 實現了數據庫管理、向量存儲操作、文檔處理以及與大語言模型（LLM）交互等功能，為應用開發提供了全面且高效的支持。

🚀 快速開始

本倉庫中的 MCP 工具能助力開發者在 Metis 應用中實現多樣化功能。下面為你介紹如何使用這些工具。

✨ 主要特性

模型上下文協議（MCP）

模型上下文協議（Model Context Protocol，簡稱 MCP）是一種標準化方式，允許語言模型與外部工具和資源進行交互。它使模型能夠訪問數據、執行操作並利用專業化的能力，超越其訓練數據的限制。

工具功能特性

• 數據庫管理工具：可與 PostgreSQL 數據庫交互，具備初始化連接、執行 SQL 查詢、獲取表結構和列出數據庫表格等功能。
• 向量存儲工具：支持與類似 Chroma 的向量數據庫交互，能初始化連接、創建和管理集合、添加和刪除文檔以及查詢相似文檔。
• 文檔處理工具：能加載、處理和分塊文檔，還可進行格式轉換和元數據提取。

📦 安裝指南

文檔未提及安裝步驟，暫不提供。

💻 使用示例

數據庫管理工具

基礎用法

// 初始化一個數據庫連接
const dbResult = await useMcpTool({
  serverName: 'database-tool',
  toolName: 'init_database_connection',
  arguments: {
    host: 'localhost',
    port: 5432,
    database: 'metis_db',
    user: 'metis_user',
    password: 'password123'
  }
});

// 執行查詢
const queryResult = await useMcpTool({
  serverName: 'database-tool',
  toolName: 'execute_query',
  arguments: {
    query: 'SELECT * FROM documents LIMIT 10'
  }
});

向量存儲工具

基礎用法

// 初始化一個向量存儲連接
const vsResult = await useMcpTool({
  serverName: 'vector-store-tool',
  toolName: 'init_vector_store',
  arguments: {
    host: 'localhost',
    port: 8000
  }
});

// 創建或獲取集合
const collectionResult = await useMcpTool({
  serverName: 'vector-store-tool',
  toolName: 'get_or_create_collection',
  arguments: {
    name: 'metis_documents'
  }
});

// 查詢集合
const queryResult = await useMcpTool({
  serverName: 'vector-store-tool',
  toolName: 'query_collection',
  arguments: {
    queryTexts: ['量子計算的工作原理是什麼？'],
    nResults: 5
  }
});

文檔處理工具

基礎用法

// 加載並處理 PDF 文檔
const pdfResult = await useMcpTool({
  serverName: 'document-processing-tool',
  toolName: 'process_pdf',
  arguments: {
    filePath: './docs/report.pdf'
  }
});

// 將文本分塊
const textChunks = await useMcpTool({
  serverName: 'document-processing-tool',
  // 原文檔此處代碼未完整，保持原樣
  toolName: '...' 
});

📚 詳細文檔

數據庫管理工具

此工具提供了與 PostgreSQL 數據庫在 Metis 應用程序中交互的功能。

• 初始化數據庫連接：通過指定數據庫的主機、端口、名稱、用戶和密碼來建立連接。
• 執行 SQL 查詢：可以執行任意 SQL 查詢語句。
• 獲取表結構：可查看數據庫中表的結構信息。
• 列出數據庫表格：能獲取數據庫中所有表格的列表。

向量存儲工具

該工具提供了與類似 Chroma 的向量數據庫在 Metis 應用程序中交互的功能。

• 初始化向量存儲連接：指定向量數據庫的主機和端口進行連接。
• 創建和管理集合：可以創建新的集合或獲取已有的集合。
• 添加文檔到集合：將文檔添加到指定的集合中。
• 查詢集合以獲取相似文檔：根據查詢文本查找集合中相似的文檔。
• 從集合刪除文檔：從指定集合中刪除文檔。

文檔處理工具

此工具提供了加載、處理和分塊文檔在 Metis 應用程序中的功能。

• 加載文檔：支持加載不同格式的文檔，如 PDF 等。
• 處理文檔內容：對文檔內容進行處理。
• 分割文檔為塊：將文檔分割成多個小塊。
• 轉換格式：可進行文檔格式的轉換。
• 提取元數據：從文檔中提取元數據信息。

🔧 技術細節

文檔未提供足夠的技術實現細節（少於 50 字），暫不展示。

📄 許可證

文檔未提及許可證信息，暫不提供。