MCP Tests

🚀 Artsy Analytics MCP Server POC

Artsy Analytics MCP Server POC是一個基於Model Context Protocol的服務器，為Claude Desktop提供Artsy合作伙伴分析工具。該項目使用 modelcontextprotocol/typescript-sdk 構建，能夠幫助用戶深入瞭解合作伙伴的各項數據指標。

🚀 快速開始

你可以按照以下步驟完成項目的安裝與配置：

1. 安裝Bun：

curl -fsSL https://bun.sh/install | bash

2. 安裝依賴：

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

3. 同步GraphQL模式：

bun sync-schema

4. 配置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"
      }
    }
  }
}

5. 重啟Claude Desktop。

✨ 主要特性

核心分析功能

• 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

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提出以下問題來使用分析工具：

• "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 添加正確的 環境變量。