Teradata MCP Server

🚀 使用 Teradata 實現 MCP 服務器的完整指南

本指南將詳細介紹如何使用 Teradata 搭建和運行 MCP 服務器，同時涵蓋集成擴展、故障排除等方面的內容，助你順利完成服務器的部署和使用。

🚀 快速開始

按照以下步驟，你可以快速搭建並運行基於 Teradata 的 MCP 服務器：

1. 安裝依賴項
2. 克隆倉庫
3. 配置環境
4. 啟動服務器
5. 集成與擴展

📦 安裝指南

安裝依賴項

在開始之前，確保已正確安裝以下工具：

• Python：建議使用版本 3.8 或更高。
• pip：用於管理 Python 包。

通過終端運行以下命令安裝所需的包：

pip install uv

這將安裝 uv 工具，用於後續的代碼運行和管理。

克隆倉庫

根據你的操作系統，在終端中執行相應的命令以克隆 Teradata MCP 服務器倉庫。

在 Windows 上

使用 PowerShell：

mkdir MCP
cd MCP
git clone https://github.com/Teradata/teradata-mcp-server.git
cd teradata-mcp-server
uv sync
.\.venv\Scripts\activate

在 Mac 上

在終端中運行：

mkdir MCP
cd MCP
git clone https://github.com/Teradata/teradata-mcp-server.git
cd teradata-mcp-server
uv sync
source .venv/bin/activate

🔧 配置環境

創建並編輯 .env 文件

在倉庫根目錄下，找到或創建一個名為 .env 的文件，並添加以下內容。根據你的實際情況填寫數據庫憑據和其他設置。

DATABASE_URI=teradata://username:password@host:1025/databaseName
SSE_HOST=127.0.0.1
SSE_PORT=8001

可選：配置 LLM 憑證

如果需要集成大語言模型（LLM），添加以下內容到 .env 文件中：

LLM_API_KEY=your_api_key_here

💻 使用示例

啟動服務器

在終端中運行以下命令以啟動 MCP 服務器：

uv run src/teradata_mcp_server/server.py

確保你已激活虛擬環境，否則需要全局安裝 server.py 所需的依賴項。

集成與擴展

使用 mcpo 工具暴露 REST 端點

運行以下命令將 MCP 服務暴露為 REST API：

uvx mcpo --port 8001 --api-key "your_api_key" -- uv run src/teradata_mcp_server/server.py

這樣，你的 Teradata 工具將成為 OpenAPI 兼容的 HTTP 端點。訪問 http://localhost:8001/docs 查看和測試 API 文檔。

集成到 Open WebUI

1. 安裝並運行 Open WebUI：

python -m venv ./env
source ./env/bin/activate  # 或者 .env\Scripts\activate 在 Windows 上
pip install open-webui
open-webui start

2. 添加 MCP 服務連接： 打開 Open WebUI 的設置界面，添加一個新的數據源或工具連接，輸入你的 MCP 服務器地址和 API 密鑰。

🛠️ 故障排除

問題：無法連接到數據庫

檢查 .env 文件中的 DATABASE_URI 是否正確。確認 Teradata 數據庫服務正在運行，並且網絡配置允許連接。

問題：啟動服務器時出現模塊未找到錯誤

確保已激活虛擬環境，或者在全局安裝了所有必要的依賴項。

⚙️ 高級功能

部署到生產環境

使用反向代理（如 Nginx）來管理流量和 SSL 證書。配置如下：

server {
    listen 80;
    server_name your_domain.com;

    location / {
        proxy_pass http://localhost:8001;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

監控與日誌

集成 Prometheus 和 Grafana 以監控服務器性能和健康狀態。修改 server.py 添加相應的監控模塊，並配置數據收集。

📚 總結

通過以上步驟，你可以成功搭建並運行一個基於 Teradata 的 MCP 服務器，並將其功能擴展為 REST 端點或集成到 Open WebUI 中。遇到問題時，請仔細檢查配置和日誌信息，逐步排查以解決問題。