MCP Spotify Server

🚀 藝術家鏡（ArtistLens）

ArtistLens 是一個強大的模型上下文協議（MCP）服務器，它提供了對 Spotify Web API 的訪問能力。藉助 ArtistLens，你能夠無縫地與 Spotify 的音樂目錄進行交互，比如搜索曲目、專輯和藝術家，還能獲取特定藝術家的詳細信息，像熱門歌曲和相關藝術家等。

當前版本: 0.4.12

🚀 快速開始

在終端中輸入 artistlens 即可運行服務器。默認情況下，它會在本機的 3001 端口上運行。

✨ 主要特性

• 提供對 Spotify Web API 的訪問，可與 Spotify 音樂目錄無縫交互。
• 支持搜索曲目、專輯和藝術家。
• 能夠獲取特定藝術家的詳細信息，如熱門歌曲和相關藝術家。

📦 安裝指南

使用 Smithery 安裝

通過 Smithery 自動安裝 ArtistLens 用於 Claude：

npx smithery install @superseoworld/artistlens

手動安裝

使用 npm 或 yarn 進行全局安裝：

npm install -g @thomaswawra/artistlens
# 或者
yarn global add @thomaswawra/artistlens

📚 詳細文檔

配置

在 ~/.config 目錄下創建或編輯 smithery.json 文件，添加以下內容：

{
  "artistlens": {
    "version": "0.4.12"
  }
}

確保 node_modules 或 yarn 目錄位於您的 PATH 環境變量中。

更新

要更新到最新版本：

# 如果全局安裝
npm update -g @thomaswawra/artistlens

# 如果使用 npx，它會自動使用最新版本
npx -y @thomaswawra/artistlens

🔧 技術細節

項目結構

代碼庫按以下目錄組織：

• src/handlers/：包含處理不同 Spotify API 端點的處理器類。
• src/types/：TypeScript 接口，定義請求和響應對象。
• src/utils/：用於 API 通信的工具函數和類。
• src/__tests__/：Jest 測試文件，測試所有功能。

測試

項目使用 Jest 進行測試。運行測試：

npm test

在開發模式下運行監視測試：

npm run test:watch

貢獻

要貢獻代碼：

1. 叉倉庫。
2. 創建功能分支 (git checkout -b feature/amazing-feature)。
3. 為您的更改添加測試。
4. 提交更改 (git commit -m 'Add some amazing feature')。
5. 推送到分支 (git push origin feature/amazing-feature)。
6. 打開一個 Pull Request。

📄 許可證

本項目採用 MIT License 進行許可。