iramk11/claude-data-buddy

Claude Data Buddy

Your friendly data analysis assistant powered by Claude!

A Model Context Protocol (MCP) server for analyzing CSV and Parquet files with natural language interface support. Claude Data Buddy makes data analysis conversational and accessible through Claude Desktop integration - just ask questions about your data!

Features

• CSV Analysis: Summarize, describe, and analyze CSV files
• Parquet Support: Full support for Parquet file format
• Comprehensive Analysis: Multi-step analysis including statistics, data types, null counts, and sample data
• Natural Language Interface: Works seamlessly with Claude Desktop for conversational data analysis
• MCP Client: Full-featured asynchronous client with demo and interactive modes
• Error Handling: Robust error handling and validation

Requirements

• Python 3.8+
• CUDA-compatible GPU (optional, for certain operations)

Installation

1. Clone the repository:

git clone <repository-url>
cd claude-data-buddy

2. Install dependencies:

pip install -r requirements.txt

Usage

Running the MCP Server

The server can be run directly or integrated with Claude Desktop.

Direct Execution:

python main.py

Claude Desktop Integration:

1. Use the provided launcher script:

./run_mcp_server.sh

2. Configure Claude Desktop by adding to your claude_desktop_config.json:

{
  "mcpServers": {
    "claude-data-buddy": {
      "command": "python",
      "args": ["/path/to/claude-data-buddy/main.py"]
    }
  }
}

Using the MCP Client

Demo Mode:

from client import MCPFileAnalyzerClient

async def main():
    client = MCPFileAnalyzerClient()
    await client.connect()
    await client.demo_mode()
    await client.disconnect()

asyncio.run(main())

Interactive Mode:

from client import MCPFileAnalyzerClient

async def main():
    client = MCPFileAnalyzerClient()
    await client.connect()
    await client.interactive_mode()
    await client.disconnect()

asyncio.run(main())

Project Structure

claude-data-buddy/
├── main.py                      # MCP server implementation
├── client.py                    # MCP client with demo/interactive modes
├── requirements.txt             # Python dependencies
├── run_mcp_server.sh            # Server launcher script
├── claude_desktop_config.json   # Claude Desktop configuration example
├── data_files/                  # Sample data files
│   ├── sample.csv
│   ├── sample.parquet
│   └── ...
└── README.md                    # This file

Available Tools

list_data_files

Lists all available CSV and Parquet files in the data directory.

summarize_csv

Provides a comprehensive summary of a CSV file including:

• Row and column counts
• Column names and data types
• Sample data (head)
• Basic statistics

summarize_parquet

Similar to summarize_csv but for Parquet files.

analyze_csv

Performs various analysis operations:

• describe: Statistical summary
• head: First few rows
• columns: Column information
• info: Dataset information
• shape: Dimensions
• nulls: Null value counts

comprehensive_analysis

Performs a complete multi-step analysis including:

• Summary statistics
• Data types
• Null value analysis
• Sample data
• Memory usage

MCP Integration

This server implements the Model Context Protocol, allowing it to work with:

• Claude Desktop
• Custom MCP clients
• Any MCP-compatible application

Example Usage

Via Claude Desktop:

User: "Summarize sample.csv as a CSV file"
Claude: [Calls summarize_csv tool and returns results]

Via Python Client:

result = await client.call_tool("summarize_csv", {"file_name": "sample.csv"})
print(result)

Acknowledgments

• Built with FastMCP
• Uses Model Context Protocol