Skip to main content
Glama
enesjakozh
reading-plus-ai

mcp-server-data-exploration

by reading-plus-ai
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

データ探索のためのMCPサーバー

MCP サーバーは、インタラクティブなデータ探索用に設計された多目的ツールです。

複雑なデータセットを明確で実用的な洞察に変換する、パーソナルなデータ サイエンティスト アシスタントです。

🚀 試してみる

  1. Claude Desktopをダウンロード

  2. インストールとセットアップ

    • macOSでは、ターミナルで次のコマンドを実行します: GXP1

  3. テンプレートとツールを読み込む

    • サーバーが実行中になったら、プロンプト テンプレートとツールが Claude Desktop に読み込まれるまで待ちます。

  4. 探索を始める

    • MCPからデータ探索プロンプトテンプレートを選択します

    • 必要な入力を行って会話を開始します。

      • csv_path : CSVファイルへのローカルパス

      • topic : 探索のトピック（例：「ニューヨークの気象パターン」または「カリフォルニアの住宅価格」）

Related MCP server: MCP Tabular Data Analysis Server

例

これらは、MCP サーバーを使用して、人間の介入なしにデータを探索する方法の例です。

事例1：カリフォルニア州の不動産価格

ビデオを見る

ケース2：ロンドンの天気

📦 コンポーネント

プロンプト

  • explore-data : データ探索タスク向けにカスタマイズ

ツール

  1. ロードCSV

    • 機能: CSVファイルをDataFrameにロードする

    • 引数:

      • csv_path (文字列、必須): CSVファイルへのパス

      • df_name (文字列、オプション): DataFrame の名前。指定されていない場合は、デフォルトで df_1、df_2 などになります。

  2. スクリプト実行

    • 機能: Pythonスクリプトを実行する

    • 引数:

      • script （文字列、必須）: 実行するスクリプト

⚙️ サーバーの変更

クロードデスクトップ構成

  • macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%/Claude/claude_desktop_config.json

開発（非公開サーバー）

"mcpServers": {
  "mcp-server-ds": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/username/src/mcp-server-ds",
      "run",
      "mcp-server-ds"
    ]
  }
}

公開サーバー

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

🛠️ 開発

建築と出版

  1. 同期依存関係

    uv sync

  2. ビルドディストリビューション

    uv build

    dist/ ディレクトリにソースとホイールのディストリビューションを生成します。

  3. PyPIに公開する

    uv publish

🤝 貢献する

貢献を歓迎します！バグの修正、機能の追加、ドキュメントの改善など、あなたの貢献がこのプロジェクトをより良くします。

問題の報告

バグに遭遇した場合やご提案がある場合は、問題セクションに問題を報告してください。以下の内容を記載してください。

  • 再現手順（該当する場合）

  • 期待される行動と実際の行動

  • スクリーンショットまたはエラーログ（該当する場合）

📜 ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。

💬 お問い合わせ

ご質問やご意見がございましたら、ぜひ問題を報告いただくか、メンテナーまでご連絡ください。一緒にこのプロジェクトを素晴らしいものにしていきましょう！

について

これはReadingPlus.AI LLCが運営するオープンソース プロジェクトであり、コミュニティ全体からの貢献を受け付けています。

Available Tools

2 tools
load_csvB

Load CSV File Tool

Purpose: Load a local CSV file into a DataFrame.

Usage Notes: • If a df_name is not provided, the tool will automatically assign names sequentially as df_1, df_2, and so on.

ParametersJSON Schema
NameRequiredDescriptionDefault
csv_pathYes
df_nameNo

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It mentions the automatic naming behavior when df_name is omitted, which is helpful. However, it doesn't address critical behavioral aspects like error handling, file format requirements, memory implications, or what happens if the CSV path is invalid.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with clear sections (Purpose, Usage Notes) and uses bullet points efficiently. Both sentences earn their place by providing essential information without unnecessary elaboration.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a data loading tool with no annotations, no output schema, and 0% schema description coverage, the description is insufficient. It doesn't explain what a DataFrame is in this context, what the tool returns, error conditions, or file format requirements. The description should provide more complete operational context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage, the schema provides no parameter documentation. The description partially compensates by explaining the df_name parameter's behavior when omitted, but doesn't clarify csv_path requirements or format. It adds some value but doesn't fully compensate for the complete lack of schema documentation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose as 'Load a local CSV file into a DataFrame' with specific verb ('Load') and resource ('CSV file'), making it immediately understandable. However, it doesn't differentiate from the sibling tool 'run_script', which appears unrelated but could potentially handle similar data operations.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides implied usage guidance through the 'Usage Notes' section about automatic naming when df_name isn't provided. However, it lacks explicit guidance on when to use this tool versus alternatives or any prerequisites for successful operation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

run_scriptB

Python Script Execution Tool

Purpose: Execute Python scripts for specific data analytics tasks.

Allowed Actions 1. Print Results: Output will be displayed as the script’s stdout. 2. [Optional] Save DataFrames: Store DataFrames in memory for future use by specifying a save_to_memory name.

Prohibited Actions 1. Overwriting Original DataFrames: Do not modify existing DataFrames to preserve their integrity for future tasks. 2. Creating Charts: Chart generation is not permitted.

ParametersJSON Schema
NameRequiredDescriptionDefault
scriptYes
save_to_memoryNo

TDQS

B3.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It effectively describes key behavioral traits: output is displayed as stdout, optional saving of DataFrames in memory, and prohibitions on overwriting original DataFrames and creating charts. This covers execution behavior, memory handling, and constraints, though it doesn't address error handling, performance limits, or security aspects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with clear sections ('Purpose', 'Allowed Actions', 'Prohibited Actions'), making it easy to scan. It's appropriately sized without unnecessary fluff, though the 'Purpose' section could be more concise. Every sentence adds value, such as clarifying output behavior and constraints.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of a script execution tool with no annotations and no output schema, the description is moderately complete. It covers execution purpose, allowed/prohibited actions, and some parameter context, but lacks details on error handling, return values, or integration with the sibling tool. For a tool with 2 parameters and significant behavioral implications, more completeness is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 0%, so the description must compensate for undocumented parameters. It mentions 'save_to_memory' in the 'Allowed Actions' section, adding some meaning beyond the schema. However, it doesn't explain the 'script' parameter's content or format, leaving a key parameter undocumented. With 2 parameters and low coverage, the description only partially compensates.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose as 'Execute Python scripts for specific data analytics tasks,' providing a specific verb ('Execute') and resource ('Python scripts'). It distinguishes from the sibling tool 'load_csv' by focusing on script execution rather than data loading. However, it doesn't specify what 'specific data analytics tasks' entail, keeping it slightly vague.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides implied usage guidance through 'Allowed Actions' and 'Prohibited Actions' sections, suggesting when to use certain features like saving DataFrames and when to avoid actions like chart generation. However, it lacks explicit guidance on when to use this tool versus the sibling 'load_csv' or other alternatives, and doesn't mention prerequisites or specific contexts for use.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updatesv1.0.0
    • Addedload_csv
    • Addedrun_script
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.2/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: load_csv is for loading CSV files into DataFrames, while run_script is for executing Python scripts for data analytics tasks. There is no overlap in functionality, and an agent would easily distinguish between them.

Naming Consistency4/5

Both tools use snake_case naming, which is consistent, but they follow different patterns: load_csv uses a verb_noun format, while run_script uses verb_noun as well but with a more generic noun. This minor deviation keeps it mostly consistent but not perfectly aligned.

Tool Count2/5

With only two tools, the server feels severely under-scoped for data exploration. Key operations like data transformation, filtering, aggregation, or visualization are missing, making it incomplete for typical data analysis workflows.

Completeness2/5

The tool set is highly incomplete for data exploration. It covers only loading data and running scripts, with no tools for common tasks like data cleaning, analysis, or exporting results. This will likely cause agent failures when trying to perform comprehensive data exploration.

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

Appeared in Searches