🚀 基因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.