Genius MCP Server

一個基於Model Context Protocol (MCP)的服務器，用於與Genius API交互，支持搜索歌詞、藝術家和獲取歌曲/藝術家詳情。

娛樂與媒體開發者工具 #歌詞搜索 #藝術家查詢 #MCP服務 #音樂API 遠程 .JavaScript

評分 : 2分

下載量 : 7

更新時間 : 2025-04-29

什麼是天才-MCP服務器？

天才-MCP服務器是一個基於Model Context Protocol (MCP)協議的工具，允許用戶通過客戶端（如Claude for Desktop或VS Code GitHub Copilot）訪問Genius API，用於搜索歌曲、藝術家以及獲取歌詞或藝術家詳情。

如何使用天才-MCP服務器？

通過配置您的客戶端，例如Claude for Desktop，連接到天才-MCP服務器。然後，您可以直接在客戶端中執行搜索操作或請求特定歌曲/藝術家的信息。

適用場景

適合需要快速查找音樂相關信息的應用場景，例如音樂教育、歌詞分析或創作輔助。

主要功能

搜索工具支持通過關鍵詞搜索歌曲、藝術家或網頁。

藝術家歌曲列表列出指定藝術家的歌曲列表。

獲取歌曲詳情通過歌曲ID獲取詳細的歌詞和信息。

獲取藝術家詳情通過藝術家ID獲取詳細的個人資料。

搜索提示提供一個預設的搜索提示模板。

優勢與侷限性

優勢

無需複雜設置即可快速集成Genius API。

支持多種客戶端，如Claude for Desktop和VS Code Copilot。

簡單易用且高效的數據查詢接口。

侷限性

僅限於公開數據查詢，無法進行高級操作。

需要有效的Genius API Key才能運行服務器。

某些功能可能依賴於客戶端的支持。

如何使用

安裝Node.js

確保已安裝Node.js版本16及以上。

克隆項目代碼

使用Git克隆項目倉庫。

配置環境變量

設置GENIUS_CLIENT_ACCESS_TOKEN為您的Genius API Key。

啟動服務器

運行服務器以監聽MCP請求。

使用案例

搜索歌曲搜索Taylor Swift的熱門歌曲。

獲取藝術家詳情獲取Kendrick Lamar的個人資料。

常見問題

如何獲得Genius API Key？

是否支持自定義提示詞？

服務器是否免費使用？

🚀 基因ius - mcp - server項目

這是一個基於Model Context Protocol（MCP）協議與Genius API交互的服務器項目。藉助該服務器，能夠實現LLM（大語言模型）與Genius平臺的數據交互，可用於搜索歌曲、藝術家信息以及其他相關資源。

🚀 快速開始

基因ius - mcp - server項目可助力LLM與Genius平臺進行數據交互。若你想快速上手，可按以下步驟操作：

克隆項目倉庫到本地。
在項目根目錄下創建.env文件，並添加GENIUS_ACCESS_TOKEN=your_client_access_token_here。
執行npm install安裝依賴。
若在開發環境，可運行npm run dev實現即時編譯；若在生產環境，可執行npm run build && npm start。

✨ 主要特性

工具

genius - search：可在Genius平臺上搜索歌曲、藝術家或其他相關內容。
genius - song：能根據歌曲ID獲取具體歌曲的信息。
genius - artist：可根據藝術家ID獲取特定藝術家的詳細信息。

資源

genius - search - prompt：提供預設的提示語，幫助用戶更高效地進行搜索操作。

📦 安裝指南

環境要求

Node.js（推薦使用版本14及以上）
npm（Node Package Manager）

安裝步驟

克隆項目倉庫到本地。
在項目根目錄下創建.env文件，並添加以下內容：
```
GENIUS_ACCESS_TOKEN=your_client_access_token_here
```
執行命令安裝依賴：
```
npm install
```
開發環境運行（即時編譯）：
```
npm run dev
```
生產環境構建並運行：
```
npm run build && npm start
```

💻 使用示例

基礎用法

搜索功能

查詢問題：“查找Taylor Swift在Genius上的歌曲。”
Claude會自動調用genius - search工具執行搜索。

獲取詳細信息

歌曲ID查詢：/genius - song?songId = 123456
藝術家ID查詢：/genius - artist?artistId = 789012

配置使用

通過Claude for Desktop配置

打開Claude的用戶目錄，找到或創建claude_desktop_config.json文件。

添加以下內容到該文件中：

{
  "mcp": {
    "servers": [
      {
        "name": "Genius API",
        "type": "custom",
        "binaryPath": "/path/to/your/genius - mcp - server/build",
        "args": [],
        "env": {
          "GENIUS_ACCESS_TOKEN": "your_client_access_token_here"
        }
      }
    ]
  }
}

保存文件並重啟Claude應用程序。

📄 許可證

本項目遵循ISC許可證，具體內容如下：

ISC License

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.