🚀 Artsy Analytics MCP Server POC
Artsy Analytics MCP Server POC是一个基于Model Context Protocol的服务器，为Claude Desktop提供Artsy合作伙伴分析工具。该项目使用 modelcontextprotocol/typescript-sdk 构建，能够帮助用户深入了解合作伙伴的各项数据指标。
🚀 快速开始
你可以按照以下步骤完成项目的安装与配置：
- 安装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//.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。
✨ 主要特性
核心分析功能
- 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//.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 添加正确的 环境变量。