ds-mcp-server

ds-mcp-server packages a FastMCP server with data science, plotting, statistics, system, and web tools, plus interactive CLI clients for OpenAI-compatible providers and Anthropic Claude.

Installation

Future PyPI install:

pip install ds-mcp-server

Local development install:

pip install -e .

Optional extras:

pip install -e ".[anthropic]"
pip install -e ".[playwright]"
pip install -e ".[all]"

Related MCP server: MCP Chat

Quick start

1. Copy .env.example to .env.

2. Fill in your provider settings.

3. Install the package.

4. Start either the MCP server or the interactive client.

OpenAI

export PROVIDER=openai
export API_KEY=sk-...
export MODEL=gpt-4o
ds-mcp-client

Claude / Anthropic

export PROVIDER=anthropic
export ANTHROPIC_API_KEY=sk-ant-...
export MODEL=claude-opus-4-5
ds-mcp-client

Gemini (OpenAI-compatible endpoint)

export PROVIDER=gemini
export API_KEY=AIza...
export MODEL=gemini-2.0-flash
ds-mcp-client

Ollama

export PROVIDER=ollama
export API_BASE_URL=http://localhost:11434/v1
export MODEL=llama3
ds-mcp-client

GPUStack / LM Studio / other OpenAI-compatible servers

export PROVIDER=openai-compat
export API_BASE_URL=https://your-endpoint.example/v1
export API_KEY=your-key
export MODEL=your-model
ds-mcp-client

Running the MCP server

ds-mcp-server

Claude Desktop MCP config

Add the server to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "ds-mcp-server": {
      "command": "ds-mcp-server",
      "args": []
    }
  }
}

Environment variables

Available tools

Interactive plots

• plot_interactive_histogram

• plot_interactive_scatterplot

• plot_interactive_boxplot

• plot_interactive_lineplot

• plot_interactive_barchart

• plot_interactive_scatter_matrix

• plot_interactive_correlation_heatmap

• generate_custom_plotly

• get_all_columns_summary

• get_column_summary

Static plots

• plot_static_histogram

• plot_static_scatterplot

• plot_static_boxplot

• plot_static_lineplot

• plot_static_barchart

• plot_static_pairplot

• plot_static_correlation_heatmap

• plot_static_wordcloud

• generate_custom_static_plot

Statistical analysis

• run_correlation

• run_group_comparison

• run_linear_regression

• rank_target_correlations

System tools

• run_shell_command

• read_file

• write_file

• patch_file

• list_directory

• find_in_files

• run_background_process

• stop_background_process

• list_background_processes

• http_request

Web tools

• search_web

• fetch_webpage

• screenshot_webpage

Requirements

• Python 3.11+

• mcp

• pandas, numpy

• plotly, matplotlib, seaborn, wordcloud

• pingouin, statsmodels

• beautifulsoup4, ddgs

• openai

• anthropic (optional)

• playwright (optional, for screenshots)