BI Chart MCP Server

🚀 BI 圖表 MCP 服務器

本項目運用 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

✨ 主要特性

• 從基於 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）和技術文檔。

📄 許可證

文檔未提及相關信息。

備註

• 該項目已從基於 TypeScript 的實現遷移到 Python。
• 如有任何問題或貢獻，請參考 CONTRIBUTING.md 文件。

希望你會喜歡這個 BI 圖表 MCP 服務器！