Shop Analytics MCP

TypeScript製のMCPサーバーで、オンラインストアのSQLiteデータベースを安全に分析します。stdioのみで動作し、6つの専門ツールを提供します。任意のSQLは受け付けません。

要件

• Node.js 24.10以上

• npm

• sqlite3 CLI（マイグレーションを再適用する場合のみ）

Related MCP server: mcp-analytics-server

インストールと起動

npm ci
npm run build
SHOP_DB_PATH=./shop.db npm start

SHOP_DB_PATHが優先されます。この変数が設定されていない場合、サーバーは現在の作業ディレクトリでshop.dbを探します。データベースへのパスはソースコードに埋め込まれていません。

データ

リポジトリには、マイグレーション済みのshop.dbが含まれています。これには顧客の国と2025年のデータが含まれています。金額はEURとして解釈され、換算されません。

元のデータベースにマイグレーションを一度だけ適用するには:

npm run migrate

元のスキーマはdatabase/schema.sqlにあり、決定的なマイグレーションはdatabase/001-add-analytics-data.sqlにあります。

クライアントへの接続

config/に既製の設定テンプレートがあります:

• claude-code.mcp.json

• codex.mcp.json

• cursor.mcp.json

選択したテンプレートの/absolute/path/to/mcp-serverを、このプロジェクトへのパスに置き換えてください。すべての設定は、stdioでdist/src/index.jsを起動し、SHOP_DB_PATHを介してshop.dbへのパスを渡します。

ツール

財務・商品指標、および注文数にはcancelledは含まれません。金額はEurサフィックス付きのフィールドで返されます。ランキングはlimitを1〜100で受け付けます。期間はYYYY-MM-DD形式の日付を使用します。

動作例

以下は、MCPクライアントがget_database_schemaを呼び出してテーブルを説明し、次にget_customer_metricsを呼び出してドイツの顧客数をカウントする例です。

セキュリティ

• SQLiteはreadOnly: trueとPRAGMA query_only = ONで開かれます。

• SQLiteオーソライザーは、書き込み、DDL、ATTACH、DETACH、トランザクションを禁止します。

• すべての値はSQLパラメータとしてバインドされます。

• ツールはSQLを受け付けないため、エージェントは破壊的なステートメントを渡すことができません。

• バリデーションエラーは、SQL、絶対パス、スタックトレースを公開しません。

テスト

npm test

テストは、8つの受け入れ質問の基準応答、国のパラメータへのSQLインジェクション、DELETEの禁止、一時データベースコピーのSHA-256不変性、stdioを介したMCPインタラクションをカバーしています。

受け入れ質問

1. 利用可能なすべてのテーブルを表示し、各テーブルに含まれる情報を説明してください。

2. ドイツからの顧客は何人ですか？

3. 最も多くの顧客がいる国はどこですか？

4. 最も多くお金を使った顧客は誰ですか？

5. ベストセラー商品トップ5は何ですか？

6. 売上上位3つの商品カテゴリは何ですか？

7. 2025年に生み出した売上はいくらですか？

8. 最も多くの注文をした顧客は誰ですか？