Teradata MCP Server

🚀 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

⚙️ 三、環境の設定

1. .env ファイルの作成と編集：

   リポジトリのルートディレクトリで、.env という名前のファイルを見つけるか、作成して以下の内容を追加します。実際の状況に合わせて、データベースの資格情報やその他の設定を入力してください。

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

2. オプション：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  # Windowsの場合は .env\Scripts\activate
   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に統合したりすることができます。問題が発生した場合は、設定とログ情報を注意深く確認し、段階的に問題を解決してください。