Pbixray MCP Server

🚀 PBIXRay MCP 服务器

PBIXRay MCP 服务器是一款基于 模型上下文协议 (MCP) 的实用工具，主要用于与 PBIX 文件进行交互。它具备数据提取、元数据查询等多种功能，能有效助力用户处理 PBIX 文件。

🚀 快速开始

PBIXRay MCP 服务器是一个基于 模型上下文协议 (MCP) 的工具，用于与 PBIX 文件交互。它提供了数据提取、元数据查询等多种功能，帮助您更好地处理 PBIX 文件。

✨ 主要特性

• 支持的文件格式：支持打开和分析 .pbix 文件。
• 数据提取：可以从 PBIX 文件中提取数据并进行处理。
• 元数据查询：提供对 PBIX 文件中包含的表结构、字段信息等元数据的查询功能。

📦 安装指南

安装

您可以使用以下命令安装 PBIXRay MCP 服务器：

pip install pbixray-mcp-server

开发模式安装

如果您打算开发或修改代码，可以按照以下步骤进行：

1. 克隆仓库：

   git clone https://github.com/username/pbixray-mcp.git
   cd pbixray-mcp
   

2. 在开发模式下安装：

   pip install -e .
   

3. 如果是从源代码安装，请创建虚拟环境并安装依赖项：

   python -m venv venv
   source venv/bin/activate  # Windows: venv\Scripts\activate
   pip install mcp pbixray numpy
   

💻 使用示例

基础用法

以下是 MCP 服务器支持的主要工具及其使用说明：

📚 详细文档

开发与测试

测试脚本

仓库中包含一些示例文件和测试脚本，帮助您快速上手：

# 使用示例文件进行测试
python tests/test_with_sample.py

# 运行交互式演示
python examples/demo.py

# 针对特定功能的测试
python test_pagination.py
python test_metadata_fix.py

开发模式

在开发过程中，可以使用 MCP 检查器：

# 先激活您的环境
source venv/bin/activate

# 运行 MCP 检查器
mcp dev src/pbixray_server.py

这将启动一个交互式会话，您可以在此调用工具并测试响应。

项目结构

pbixray-mcp/
├── README.md            - 该文件
├── INSTALLATION.md      - 详细的安装说明
├── src/                 - 源代码
│   ├── __init__.py
│   └── pbixray_server.py
├── tests/               - 测试脚本
│   ├── __init__.py
│   ├── conftest.py
│   ├── test_server.py
│   └── test_with_sample.py
├── examples/            - 示例脚本和配置
│   ├── demo.py
│   └── config/
├── demo/                - 示例 PBIX 文件
│   ├── README.md
│   └── AdventureWorks Sales.pbix
└── docs/                - 额外文档
    └── ROADMAP.md

🤝 贡献

欢迎任何贡献！

🙏 致谢

• Hugoberry - PBIX 文件分析工具的作者。
• 开源社区的支持者。

📄 许可证

本项目使用 MIT 许可证。