BI Chart MCP Server

🚀 BI Chart MCP Server

This project implements a BI chart MCP server using Python. Previously, this functionality was prototyped in TypeScript, but the current maintenance version is written in Python.

🚀 Quick Start

✨ Features

• Implemented in Python, migrating from a TypeScript prototype.
• Well - structured project with clear separation of modules for data loading, resource management, and visualization.

📦 Installation

1. Clone the repository.
2. Create and activate a virtual environment:

   python -m venv .venv
   .venv\Scripts\activate   # For Windows systems
   

3. Install the required dependencies:

   pip install -r requirements.txt
   

💻 Usage Examples

Basic Usage

To start the server, you can use the provided script:

python scripts/run_server.py

Or start the server directly from the module:

python -m mcp_bi_visualizer.server

Testing

Run the tests using your preferred test runner. For example, using pytest:

pytest

📚 Documentation

Project Structure

• mcp_bi_visualizer/: Contains the main service code and modules.
  • server.py: The main entry point to start the MCP server.
  • data/: Data loading and processing module.
    • loader.py
    • processor.py
  • resources/: Module for managing project resources.
    • manager.py
    • memo.py
  • visualization/: Chart components.
    • renderer.py
    • vega_lite.py
• scripts/
  • run_server.py: Script to start the server.
• tests/: Unit tests for the server and chart components.
• Other files include configuration files (e.g., pyproject.toml, requirements.txt, setup.py) and technical documentation.

📄 License

Not provided in the original document.

💡 Usage Tip

• The project has been migrated from a TypeScript - based implementation to Python.
• For any issues or contributions, please refer to the CONTRIBUTING.md file.

We hope you'll enjoy using this BI chart MCP server!