Genius MCP Server

🚀 基因ius - mcp - server項目

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

🚀 快速開始

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

1. 克隆項目倉庫到本地。
2. 在項目根目錄下創建.env文件，並添加GENIUS_ACCESS_TOKEN=your_client_access_token_here。
3. 執行npm install安裝依賴。
4. 若在開發環境，可運行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）

安裝步驟

1. 克隆項目倉庫到本地。
2. 在項目根目錄下創建.env文件，並添加以下內容：

   GENIUS_ACCESS_TOKEN=your_client_access_token_here
   

3. 執行命令安裝依賴：

   npm install
   

4. 開發環境運行（即時編譯）：

   npm run dev
   

5. 生產環境構建並運行：

   npm run build && npm start
   

💻 使用示例

基礎用法

搜索功能

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

獲取詳細信息

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

配置使用

通過Claude for Desktop配置

1. 打開Claude的用戶目錄，找到或創建claude_desktop_config.json文件。
2. 添加以下內容到該文件中：

   {
     "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"
           }
         }
       ]
     }
   }
   

3. 保存文件並重啟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.