BI Chart MCP Server

🚀 BI チャート MCP サーバー

このプロジェクトは Python を使用して BI チャート MCP サーバーを実装しています。以前はこの機能は TypeScript でプロトタイプ開発されていましたが、現在のメンテナンスバージョンは Python で記述されています。

🚀 クイックスタート

このセクションでは、BI チャート MCP サーバーの基本的な使い方を説明します。以下の手順に従って、サーバーを起動してみましょう。

サーバーの起動方法

以下の 2 つの方法でサーバーを起動できます。

スクリプトを使用する方法

python scripts/run_server.py

モジュールから直接起動する方法

python -m mcp_bi_visualizer.server

✨ 主な機能

• Python を使用した BI チャート MCP サーバーの実装。
• 以前の TypeScript ベースの実装から Python への移行。

📦 インストール

以下の手順に従って、このプロジェクトをインストールします。

1. リポジトリをクローンします。
2. 仮想環境を作成してアクティブ化します。

   python -m venv .venv
   .venv\Scripts\activate   # Windows システム
   

3. 必要な依存関係をインストールします。

   pip install -r requirements.txt
   

💻 使用例

基本的な使用法

サーバーを起動する基本的なコマンドは以下の通りです。

# スクリプトを使用してサーバーを起動
python scripts/run_server.py

# モジュールから直接サーバーを起動
python -m mcp_bi_visualizer.server

高度な使用法

テストを実行する場合は、以下のコマンドを使用します。

# pytest を使用してテストを実行
pytest

📚 ドキュメント

プロジェクト構造

このプロジェクトの構造は以下の通りです。

• mcp_bi_visualizer/：メインサービスのコードとモジュールが含まれています。
  • server.py：MCP サーバーを起動する主要なエントリーポイントです。
  • data/：データのロードと処理を行うモジュールです。
    • loader.py
    • processor.py
  • resources/：プロジェクトのリソースを管理するモジュールです。
    • manager.py
    • memo.py
  • visualization/：チャートコンポーネントです。
    • renderer.py
    • vega_lite.py
• scripts/
  • run_server.py：サーバーを起動するスクリプトです。
• tests/：サーバーとチャートコンポーネントの単体テストが含まれています。
• その他のファイルには、設定ファイル（例：pyproject.toml、requirements.txt、setup.py）や技術ドキュメントが含まれています。

📄 ライセンス

本プロジェクトに関するライセンス情報は、CONTRIBUTING.md ファイルを参照してください。

🔖 備考

• このプロジェクトは、TypeScript ベースの実装から Python へ移行されています。
• 何か問題や貢献がある場合は、CONTRIBUTING.md ファイルを参照してください。

この BI チャート MCP サーバーを楽しんでください！