Mcp Data Visualization Server

🎯 MCP Data Visualization Server

DuckDB と Databricks に対応し、Claude Desktop を使って自然言語から美しくインタラクティブなデータ可視化を作成できます。インストールは 1 つのコマンドだけです！

✨ 特長

• 🚀 1 コマンドでインストール - pip install mcp-visualization-duckdb
• 🔧 自動設定 - Claude Desktop を自動でセットアップします
• 🗣️ 自然言語インターフェース - Claude とチャットして可視化を作成できます
• 📊 インタラクティブなグラフ - Plotly を活用した HTML ウィジェット
• 🏢 Databricks 連携 - 認証情報を安全に管理しながら Databricks SQL ウェアハウスに接続できます
• 🗃️ DuckDB 対応 - CSV インポートとインタラクティブなブラウザーを備えたローカルデータベース
• 🔄 複数のデータベースに対応 - DuckDB と Databricks をシームレスに切り替えられます
• 🧠 ルールベースの分析 - 外部 LLM に依存せず、適切なグラフを提案します
• 📈 多様なグラフ形式 - 棒グラフ、折れ線グラフ、散布図、円グラフ、ヒストグラム、箱ひげ図、ヒートマップ、面グラフ
• 🔍 スマートな分析結果 - 統計分析とパターン検出を自動で行います
• 🛡️ セキュリティを最優先 - SQL インジェクション対策、認証情報の暗号化保存
• ⚡ 外部依存なし - Claude Desktop と完全にオフラインで動作します

🚀 クイックインストール

オプション A：DuckDB（ローカルデータベース）

# 1. Install the package (includes DuckDB and all dependencies)
pip install mcp-visualization-duckdb

# 2. Configure Claude Desktop automatically
mcp-viz configure

# 3. Restart Claude Desktop and start chatting!

これで完了です！手動で設定する必要はありません。

注：DuckDB やその他すべての依存関係は、パッケージとともに自動でインストールされます。別途データベースをインストールする必要はありません！

オプション B：Databricks（エンタープライズデータウェアハウス）

# 1. Install the package
pip install mcp-visualization-duckdb

# 2. Configure Databricks credentials (secure, interactive setup)
mcp-viz databricks configure

# 3. Configure Claude Desktop (auto-detects Databricks)
mcp-viz configure

# 4. Restart Claude Desktop and start chatting!

Databricks では、以下が必要です：

• Databricks ワークスペースのホスト名（例：your-company.cloud.databricks.com）
• SQL ウェアハウスの HTTP パス（例：/sql/1.0/warehouses/abc123）
• 個人用アクセストークン（Databricks の User Settings > Developer > Access Tokens で生成）

🔒 セキュリティ：認証情報は、システムのキーリングまたは暗号化ファイルを使って安全に保存されます。トークンが平文やコマンド履歴に保存されることはありません。

インストーラーが自動で行うこと：

• ✅ プラットフォームを検出（Windows／Mac／Linux）
• ✅ Claude Desktop の設定ファイルを自動で検索
• ✅ データベースの種類を自動検出（DuckDB または Databricks）
• ✅ サンプルデータを使ってデータベースをセットアップ（DuckDB）
• ✅ 認証情報を安全に保存（Databricks）
• ✅ パスを適切に設定
• ✅ 既存の設定をバックアップ
• ✅ セットアップが正しく動作することを検証

🚀 インストール後

インストールが完了すると、以下の詳しい手順が表示されます：

• 選択したデータベースの次の手順
• クイックスタートコマンド
• サンプルデータベースへのリンク
• 試してみるためのクエリ例

いつでも mcp-viz-setup を実行すると、インストール後のガイドを再度確認できます！

🔄 セットアップ後の継続的な使用

✅ セットアップは 1 回だけ

# Run these commands ONCE:
mcp-viz databricks configure  # First time Databricks setup
mcp-viz configure             # Configure Claude Desktop  
# Restart Claude Desktop

📋 日常的な使用 — 再設定は不要

# Just open Claude Desktop and start chatting:
"What Databricks catalogs are available?"
"List tables in the sales catalog" 
"Create a chart of revenue by region"

🔍 いつでもステータスを確認

mcp-viz databricks status    # Shows if credentials exist
mcp-viz databricks test      # Test connection and browse catalogs
mcp-viz status              # Shows MCP server configuration

🔄 再設定が必要になる場合

• ❌ トークンの有効期限が切れたとき（個人用アクセストークンには有効期限を設定できる場合があります）
• ❌ ワークスペースを変更するとき（別の Databricks インスタンス）
• ❌ SQL ウェアハウスを変更するとき（別の HTTP パス）
• ❌ 認証情報に問題があるとき（mcp-viz databricks remove を実行してから再設定）

💾 認証情報の安全な保存

• 🔒 ディスク上またはシステムのキーリング内で暗号化
• 🔄 Claude Desktop の起動時に自動で読み込み
• ⚡ 認証を繰り返す必要なし

📝 注：初期セットアップ後は、追加の設定を行わずに Claude Desktop を通常どおり使用できます！

🎮 Claude Desktop での使用方法

インストール後は、自然な言葉で Claude に話しかけるだけです：

データ分析

• 「利用可能なテーブルは何ですか？」 — データベースのテーブル一覧を表示
• 「利用可能な Databricks カタログは何ですか？」 — Databricks のカタログを確認
• 「sales カタログのスキーマを表示して」 — スキーマの一覧を表示
• 「sales テーブルを分析して」 — テーブル情報を取得
• 「売上上位 10 件の商品を表示して」 — データをクエリ

ビジュアライゼーションの作成

• 「地域別の売上を棒グラフにしてください」 - グラフを生成します
• 「価格と数量の相関関係を見せてください」 - 散布図を作成します
• 「顧客セグメントの円グラフを作成してください」 - カテゴリの内訳を示します
• 「売上の推移を時系列で可視化してください」 - 時系列分析を行います

データベース管理

DuckDB：

• 「Downloads フォルダー内のデータベースを参照してください」 - 対話型データベースブラウザーを開きます
• 「C:/path/to/mydata.duckdb に接続してください」 - データベースを切り替えます
• 「Downloads/sales.csv を 'sales' テーブルとして読み込んでください」 - データをインポートします

Databricks：

• 「marketing カタログに切り替えてください」 - カタログを移動します
• 「sales カタログ内のスキーマを一覧表示してください」 - スキーマを参照します
• 「現在どのデータベースに接続していますか？」 - 接続情報を確認します

🔧 CLI コマンド

このパッケージには、強力な CLI が含まれています。

# Configuration
mcp-viz configure              # Interactive setup (auto-detects database type)
mcp-viz configure --auto       # Automatic setup with defaults
mcp-viz status                 # Check configuration status

# Management  
mcp-viz test                   # Test server functionality
mcp-viz remove                 # Remove server from Claude Desktop

# DuckDB Database
mcp-viz create-db              # Create sample database
mcp-viz create-db --path ./my-data.duckdb  # Create at specific path

# Databricks Integration
mcp-viz databricks configure   # Setup Databricks credentials (interactive)
mcp-viz databricks status      # Check Databricks connection status
mcp-viz databricks test        # Test connection and browse catalogs
mcp-viz databricks remove      # Remove stored credentials

📊 対応しているグラフの種類

グラフの種類	用途	リクエストの例
棒グラフ	カテゴリを比較する	「地域別の売上を見せてください」
折れ線グラフ	時間経過に伴う傾向を示す	「月ごとの収益をプロットしてください」
散布図	関係性を調べる	「価格と数量の関係」
円グラフ	割合を示す	「顧客セグメントの内訳」
ヒストグラム	分布を分析する	「注文金額の分布」
箱ひげ図	分布を比較する	「カテゴリ別の価格帯」
ヒートマップ	相関関係を示す	「指標の相関行列」
面グラフ	累積的な傾向を示す	「時間経過に伴う累積売上」

🛠️ トラブルシューティング

Claude Desktop で「サーバーが見つかりません」と表示される

# Check configuration status
mcp-viz status

# Reconfigure if needed
mcp-viz configure --force

# Restart Claude Desktop completely

「不明なツール」エラー

# Test server functionality
mcp-viz test

# Check if all dependencies are installed
pip install --upgrade mcp-visualization-duckdb

データベースの問題

# Create a fresh database with sample data
mcp-viz create-db

# Check current configuration
mcp-viz status

🔧 詳細設定

カスタムデータベースパス

インストーラーでデータベースの場所を指定するよう求められます。または、次のように指定できます。

# During configuration
mcp-viz configure
# Database path [/home/user/.mcp-visualization/data.duckdb]: /path/to/my/data.duckdb

複数のデータベース

Claude Desktop を使って、データベースを簡単に切り替えられます。

• 「Documents フォルダー内のデータベースを参照してください」
• 「/path/to/another/database.duckdb に接続してください」
• 「現在接続しているデータベースを教えてください」

💾 サンプルデータ

🎯 組み込みのサンプルデータ

このパッケージでは、次のサンプルデータが自動的に作成されます。

• 売上データ - 地域や製品を対象とした365日分の売上
• 顧客データ - 顧客属性を含む1000件の顧客レコード
• 製品データ - カテゴリと価格情報を含む100件の製品

🌟 追加のサンプルデータベース

さらにデータを調べてみませんか？ 次の高品質なサンプルデータベースをご覧ください。

TimeStored のサンプル DuckDB データベース

利用できるデータセットは次のとおりです。

• 金融データ - 株価、取引データ、市場分析
• NYC タクシー - 地理空間データを含む、ニューヨーク市の実際のタクシー乗車記録
• TPC-H ベンチマーク - 標準的なデータベース性能テスト用データ
• E コマース - 製品カタログ、注文、顧客行動
• IoT センサーデータ - 時系列のセンサー測定値とテレメトリ

任意の .duckdb ファイルをダウンロードして読み込むだけです。

# Download a sample database, then:
"Load database from Downloads/nyc-taxi.duckdb"
"What tables are available in this database?"
"Create a heatmap of taxi pickups by hour and day"

データのビジュアライゼーション機能をテスト、学習、デモするのに最適です。

🏗️ 開発環境のセットアップ

コントリビュートを希望する開発者向け：

# Clone repository
git clone https://github.com/your-github-username/mcp-visualization-duckdb.git
cd mcp-visualization-duckdb

# Install in development mode
pip install -e .

# Configure for development
mcp-viz configure

# Run tests
python test_package.py

詳しい手順については、開発ガイドをご覧ください。

❓ よくある質問

Q: 毎回 mcp-viz databricks configure を実行する必要がありますか？

A: いいえ！ 初回セットアップ時に一度だけ実行します。その後は：

• ✅ 認証情報は安全に保存され、自動的に読み込まれます
• ✅ Claude Desktop を開いてチャットを始めるだけです
• ✅ 認証を繰り返す必要はありません

Q: Databricks がまだ接続されているかどうかを確認するには？

A： 次のコマンドでいつでも確認できます。

mcp-viz databricks status    # Shows connection status
mcp-viz databricks test      # Tests connection and shows catalogs

Q: 再設定が必要になるのはどのような場合ですか？

A： 次の場合に限られます。

• アクセストークンの有効期限が切れたとき
• Databricks ワークスペースを変更したとき
• 別の SQL ウェアハウスに切り替えたとき
• 認証情報が破損したとき（まれです）

Q: 認証情報は安全ですか？

A： はい！ 認証情報は次のように保護されます。

• 🔒 ディスク上で暗号化されるか、システムのキーチェーンに保存されます
• 🚫 平文やコマンド履歴に保存されることはありません
• ⚡ 必要に応じて自動的に読み込まれます

Q: DuckDB と Databricks の両方を使用できますか？

A: はい！サーバーは使用するデータベースの種類を自動的に検出します。

• Databricks を設定：mcp-viz databricks configure
• DuckDB を設定：mcp-viz configure
• サーバーは適切な方を自動的に使用します

📦 パッケージ情報

• PyPI: https://pypi.org/project/mcp-visualization-duckdb/
• リポジトリ: https://github.com/your-github-username/mcp-visualization-duckdb
• ライセンス: MIT

🤝 貢献

貢献を歓迎します！このパッケージは開発しやすい構成になっています。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します
3. 変更を加えます
4. テストを実行します：python test_package.py
5. プルリクエストを送信します

🙏 謝辞

• Anthropic による Model Context Protocol
• 高速な分析処理を実現する DuckDB
• インタラクティブな可視化を実現する Plotly
• 素晴らしい AI インターフェースを提供する Claude Desktop

---

Claude Desktop でデータ分析を変革する準備はできましたか？

pip install mcp-visualization-duckdb && mcp-viz configure

🎉 これで完了です！ Claude とデータについてチャットを始めましょう！