Playlist Matcher

排序

根据艺术家和流派的相似性，自动将您的Spotify喜欢的歌曲排序到播放列表中。

特性

• 网络界面 -漂亮的Spotify风格的仪表板，用于管理您的设置和查看比赛历史记录
• 自动调度 -设置您喜欢的间隔和时间，其余的由Sortify处理
• 基于类型的匹配 -使用艺术家流派、重叠检测和流行度进行智能匹配
• 比赛历史 -跟踪已分类到播放列表中的所有歌曲
• 多用户支持 -PostgreSQL后端用于生产部署
• MCP集成 -还可以作为Claude Code的MCP服务器

运作原理

Sortify分析您最近喜欢的歌曲，并使用以下公式将其与现有播放列表进行匹配：

score = (artistOverlap × 0.35) +
        (genreOverlap × 0.25) +
        (weightedGenreScore × 0.25) +
        (popularitySimilarity × 0.15)

快速启动（地方发展）

1.获取Spotify API证书

1. 首选 Spotify开发者仪表板
2. 创建新应用程序
3. 添加以下重定向URI：

- http://localhost:3001/api/auth/callback （适用于网络模式） - http://127.0.0.1:8888/callback （适用于MCP模式）

1. 复制您的 客户端ID

2.安装并运行

# Install dependencies
npm install
cd web && npm install && cd ..

# Build
npm run build
cd web && npm run build && cd ..

# Set environment variable
export SPOTIFY_CLIENT_ID=your_client_id_here

# Run the web server
npm run web

3.打开应用程序

访问 http://localhost:5173 并使用Spotify登录。

生产部署

为了生产，您需要：

• PostgreSQL 数据库
• 后端 （例如，铁路）
• 前端 （例如，Vercel）

环境变量

后端：

SPOTIFY_CLIENT_ID=your_client_id
DATABASE_URL=postgresql://...
REDIRECT_URI=https://your-backend.com/api/auth/callback
FRONTEND_URL=https://your-frontend.com
BETA_WHITELIST=user1@example.com,user2@example.com  # Optional: comma-separated emails for beta access

前端：

VITE_API_URL=https://your-backend.com

MCP模式（克劳德码）

Sortify还可以作为Claude Code的MCP服务器。

添加到您的 ~/.claude.json:

{
  "playlist-matcher": {
    "command": "node",
    "args": ["/path/to/playlist-matcher/dist/index.js"],
    "env": {
      "SPOTIFY_CLIENT_ID": "your_client_id_here"
    }
  }
}

MCP工具

项目结构

sortify/
├── src/                      # Backend (Express + MCP server)
│   ├── web-server.ts         # Express API server
│   ├── server.ts             # MCP server tools
│   ├── scheduler/            # Cron job runner
│   ├── matching/             # Matching algorithm
│   │   └── genre-matcher.ts  # Genre-based matching
│   ├── storage/              # Data persistence
│   │   ├── database.ts       # PostgreSQL setup
│   │   └── pg-*.ts           # PostgreSQL stores
│   ├── spotify/              # Spotify API client
│   └── auth/                 # OAuth handling
│
├── web/                      # Frontend (React + Vite)
│   └── src/
│       ├── components/       # React components
│       │   ├── Home.tsx      # Settings page
│       │   ├── NewDashboard.tsx  # Match history
│       │   └── About.tsx     # About page
│       └── api.ts            # API client
│
└── package.json

API终点

许可证

麻省理工学院