uv init mcp-server-demo
cd mcp-server-demo
uv に "mcp[cli]" を追加 uv pip install mcp-python pandas matplotlib openpyxl fastapi uvicorn pillo uv run mcp dev server.py
uv 実行 mcp インストール server.py
Excel MCP サーバー
このプロジェクトは、Excelデータを操作するためのツールとリソースを提供するModel Context Protocol(MCP)サーバーを実装します。このサーバーは、シンプルなAPIを通じてExcelデータの読み取り、更新、フィルタリング、視覚化の機能を提供します。
特徴
- Excel 操作: Excel ファイルの読み取りと書き込み
- データフィルタリング: さまざまな基準に基づいてデータをフィルタリングおよび検索します
- データ分析: 統計サマリーとピボットテーブルを生成する
- データの視覚化: さまざまなチャートと視覚化を作成する
- 更新操作: セルの更新、行の追加、行の削除
- 異常検出:数値データ内の外れ値を見つける
- チャートの推奨事項: 適切な視覚化を自動的に提案します
インストール
- 必要な依存関係をインストールします。
- このリポジトリをクローンするか、ファイルをダウンロードしてください:
server.py
- MCP サーバーの実装client.py
- 機能を紹介するデモクライアント
使用法
サーバーの起動
サーバーを実行します。
デフォルトでは、サーバーはhttp://localhost:8000
で起動します。
クライアントデモの使用
クライアント デモ スクリプトでは、MCP サーバーで実行できるさまざまな操作を紹介します。
これにより、次のようになります。
- サンプル Excel ファイルを作成する (存在しない場合)
- 基本的なExcel操作を実演する
- データフィルタリング機能を表示
- 視覚化を生成する
- データ更新を実行する
- データの異常を検出する
APIを直接使用する
MCP サーバーの API を直接使用できます。
ツールAPI
/tools/{tool_name}
への POST リクエストを使用してツールを呼び出します。
リソースAPI
/resources/{resource_path}
への GET または POST リクエストを使用してリソースにアクセスします。
利用可能なツール
Excel操作
read_excel
- Excelファイルからデータを読み取るwrite_excel
- Excelファイルにデータを書き込むget_excel_sheets
- Excel ファイル内のシートのリストを取得します
データフィルタリング
filter_data
- 条件に基づいて Excel データをフィルタリングするsearch_data
- Excelデータ内の用語を検索する
データ分析
summarize_data
- Excelデータの統計概要を取得しますcreate_pivot_table
- Excelデータからピボットテーブルを作成する
データの可視化
visualize_chart
- さまざまな種類のチャートを作成します(棒グラフ、折れ線グラフ、散布図、円グラフ、履歴グラフ)recommend_charts
- データ構造に基づいてチャートの推奨事項を取得します
更新操作
update_cell
- Excel ファイル内の特定のセルを更新するadd_row
- Excelファイルに新しい行を追加するdelete_rows
- フィルターに基づいて Excel ファイルから行を削除します
追加機能
detect_anomalies
- Zスコアを使用して数値データの異常を見つけるexport_to_csv
- Excel データを CSV 形式でエクスポートします
利用可能なリソース
excel://{filename}/sheets
- Excelファイル内のシートのリストを取得しますexcel://{filename}/sheet/{sheet_name}
- 特定のシートからデータを取得するexcel://{filename}/sheet/{sheet_name}/summary
- シートデータの概要を取得しますexcel://{filename}/sheet/{sheet_name}/filter
- シート内のデータをフィルタリングする
例: カスタムクライアントの作成
MCP サーバーと対話するための独自のクライアントを作成できます。
AIモデルとの統合
この MCP サーバーは、Claude などの AI モデルと簡単に統合でき、Excel データへの自然言語インターフェースを提供できます。
- AIはユーザーのリクエストに基づいて適切なMCPツールを呼び出すことができます。
- ツールによって返されたデータを処理する
- 洞察と視覚化をユーザーに提示する
これにより、自然言語の要求を理解して Excel データを分析および操作できるインタラクティブな「Excel アシスタント」が作成されます。
This server cannot be installed
シンプルな API を通じて Excel データの読み取り、更新、フィルタリング、視覚化を行うツールを提供するモデル コンテキスト プロトコル サーバー。
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that provides tools for reading Excel (xlsx) files, enabling extraction of data from entire workbooks or specific sheets with results returned in structured JSON format.Last updated -35Apache 2.0
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to read from and write to Microsoft Excel files, supporting formats like xlsx, xlsm, xltx, and xltm.Last updated -61,629510MIT License
- AsecurityAlicenseAqualityEnables seamless reading, writing, and analyzing of Excel files through Model Context Protocol, with features for worksheet management, structure analysis, and automated caching.Last updated -810241MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables interaction with Microsoft 365 services (Excel, Calendar, Mail, OneDrive, Teams, etc.) through the Graph API, allowing AI assistants to manage Microsoft 365 resources via natural language.Last updated -2,971258MIT License