MCP Tests

## 🚀 Artsy Analytics MCP Server POC

Claude Desktop向けのArtsyパートナー分析ツールを提供するModel Context Protocolサーバーです。[modelcontextprotocol/typescript-sdk](https://github.com/modelcontextprotocol/typescript-sdk)を使用して構築されています。

## 🚀 クイックスタート
このサーバーはClaude Desktop向けのArtsyパートナー分析ツールを提供します。以下の手順に従ってセットアップしてください。

## ✨ 主な機能

### コア分析
- **get_partner_activity_stats** - ページビューと問い合わせを含むパートナーのアクティビティ概要
- **get_partner_sales_stats** - 販売パフォーマンスの指標とトレンド
- **get_partner_artworks_published_stats** - アートワークの公開分析
- **get_partner_audience_stats** - オーディエンス指標と訪問者数
- **get_partner_inquiries_stats** - 問い合わせの量と応答分析
- **get_complete_partner_analytics** - 包括的な分析ダッシュボード
- **get_partner_modern_pageviews** - 時系列を含む強化されたページビュー分析
- **get_partner_time_series_analytics** - ページビューまたはアートワークの時系列データ
- **get_partner_sales_time_series** - 収益追跡を含む販売分析
- **get_partner_inquiry_time_series** - 応答時間を含む問い合わせトレンド

### コンテンツパフォーマンス
- **get_partner_top_artworks** - ビュー数が多い上位のアートワーク
- **get_partner_top_content** - 上位のコンテンツ（アートワーク、ショー、アーティスト、ビューイングルーム）

### オーディエンスインサイト
- **get_partner_visitor_demographics** - 国、デバイス、紹介元別の訪問者内訳
- **custom_graphql_query** - カスタムGraphQLクエリを実行

## 📦 インストール

### Bunのインストール
```bash
curl -fsSL https://bun.sh/install | bash

依存関係のインストール

git clone https://github.com/damassi/mcp-tests.git
cd mcp-tests
bun install

GraphQLスキーマの同期

bun sync-schema

Claude Desktop MCP設定の構成

code ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "artsy-analytics": {
      "command": "/Users/<user-name>/.bun/bin/bun",
      "args": ["/path/to/mcp/src/mcp-server.ts"],
      "env": {
        "CLAUDE_DESKTOP": "true",
        "METAPHYSICS_ENDPOINT": "your_endpoint",
        "USER_ID": "your_user_id",
        "X_ACCESS_TOKEN": "your_token"
      }
    }
  }
}

Claude Desktopの再起動

💻 使用例

基本的な使用法

Claudeに以下のような質問をしてください。

• "Show visitor demographics for pace-gallery"
• "Get sales trends for hauser-wirth over 16 weeks"
• "What are the top artworks for gagosian-gallery?"

🔧 技術詳細

開発時の実行

開発時には以下のコマンドを実行できます。

bun dev

# スキーマからGraphQLタイプを生成
bun gql

インスペクターの起動

その後、modelcontextprotocolのインスペクターを起動します。

bunx @modelcontextprotocol/inspector

セットアップが以下のように見えることを確認し、（重要！）.env.exampleに記載されている正しいEnvironment Variablesを追加してください。